Gå til indholdet

Modeller

Alle modeller bruger camelCase JSON. Timestamps er ISO 8601 UTC (fx 2017-07-21T17:32:28Z).

Model-oversigt

Model Beskrivelse Endpoint
smsRequest Send SMS (request body) POST /sms/v2/meeting/{uuid}
smsResponse Send SMS (respons) POST /sms/v2/meeting/{uuid}
smsStatus Leveringsstatus (element i array) GET /sms/v2/meeting/{uuid}
status Status-enum smsResponse, smsStatus
detailedError Fejlrespons 400, 401, 403, 404

smsRequest

Request body til POST /sms/v2/meeting/{uuid}.

Felt Type Påkrævet Beskrivelse
message string Ja SMS-tekst — skal indeholde %meeting_url% (max 480 tegn)
to string Ja Modtagerens telefonnummer (max 20 tegn, fx +4512345678)

JSON-eksempel

{
  "message": "Du er inviteret til videomøde. Deltag her: %meeting_url%",
  "to": "+4512345678"
}

Gateway'en erstatter %meeting_url% med det faktiske mødelink før afsendelse.

smsResponse

Respons fra POST /sms/v2/meeting/{uuid}.

Felt Type Beskrivelse
reference uuid Unik reference til SMS'en — brug til sporning
status status Initial status (typisk Registered)

JSON-eksempel

{
  "reference": "5d950cbf-5a59-40f4-80dd-f7a25f3ac8bb",
  "status": "Registered"
}

smsStatus

Element i array fra GET /sms/v2/meeting/{uuid}.

Felt Type Beskrivelse
reference uuid Unik reference (samme som ved POST)
status status Aktuel leveringsstatus
to string Modtagerens telefonnummer
sendDateTime datetime Tidspunkt for afsendelse (UTC)

JSON-eksempel

{
  "reference": "5d950cbf-5a59-40f4-80dd-f7a25f3ac8bb",
  "status": "Delivered",
  "to": "+4512345678",
  "sendDateTime": "2017-07-21T17:32:28Z"
}

status

Leveringsstatus for en SMS.

Værdi Beskrivelse
Registered SMS registreret hos gateway — afventer afsendelse
InProgress Afsendelse i gang
Delivered Leveret til modtager
Failed Afsendelse fejlede
Unknown Ukendt status

Typisk flow: Registered → InProgress → Delivered (eller Failed).

detailedError

Udvidet fejlrespons (arver basicError).

Felt Type Beskrivelse
detailed_error string Detaljeret fejlbeskrivelse
detailed_error_code string 10 = valideringsfejl, 20 = generel fejl

basicError

Felt Type Beskrivelse
timestamp datetime Fejltidspunkt
status integer HTTP-statuskode
error string Fejlbesked
path string Request path

Se også

Ændringshistorik

Dato Ændring
2026-06-27 Første model-reference for VDX SMS Gateway v2