SMS-Gateway

SMS-Schnellstart

OTP-Codes, Benachrichtigungen und transaktionale SMS in über 190 Länder senden. Jede Nachricht gibt einen Zustellbeleg zurück, damit du weißt, dass sie angekommen ist.

Testen ohne echte SMS? Sandbox-Modus verwenden – keine echten Nachrichten gesendet, vorhersehbare OTP-Codes und keine Abrechnung.

1SMS senden

Empfängernummer und Nachrichtentext per POST senden. Das Feld from legt die für den Nutzer sichtbare Absender-ID fest (Carrier-Unterstützung variiert je Land).

POST/api/v1/connect-hub/sms

bash

curl -X POST https://api.novauth.com/api/v1/connect-hub/sms \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "to":   "+14155552671",
    "text": "Your verification code is 482951. Valid for 10 minutes.",
    "from": "Novauth"
  }'

200 OK — Antwort

json

{
  "messageId": "a3f2c1d0-4e5b-6c7d-8e9f-0a1b2c3d4e5f",  // save for delivery check
  "from":      "Novauth",
  "to":        "+14155552671"
}

Textlänge: SMS-Nachrichten sind auf 160 Zeichen pro Segment begrenzt. Nachrichten bis zu 4 096 Zeichen werden akzeptiert – sie werden automatisch in verkettete Segmente aufgeteilt und auf dem Endgerät wieder zusammengesetzt.

2Zustellstatus prüfen

Den SDR-Endpunkt (SMS Delivery Report) abfragen, um zu prüfen, ob die Nachricht das Endgerät erreicht hat. Kurz nach dem Senden prüfen – typische Zustellung in unter 5 Sekunden.

GET/api/v1/connect-hub/sms/{messageId}/sdr

bash

curl https://api.novauth.com/api/v1/connect-hub/sms/a3f2c1d0-.../sdr \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID"

3Verifizierungsergebnis melden

Sobald der Nutzer den empfangenen Code eingibt, das Ergebnis per POST an den Webhook-Endpunkt senden, um den SMS-Datensatz zu schließen und das Ergebnis zu erfassen.

POST/api/v1/connect-hub/sms/webhook

bash

# Report the verification outcome from your backend
curl -X POST https://api.novauth.com/api/v1/connect-hub/sms/webhook \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "id":     "a3f2c1d0-...",
    "status": "Success"
  }'

API-Referenz

POST/smsSMS-Nachricht senden

GET/sms/{messageId}/sdrSMS-Zustellbericht abrufen

POST/sms/webhookVerifizierungsergebnis melden

POST/sms/sdrAlle SMS-Datensätze auflisten (paginiert)

Request-Body — POST /sms

tostringrequiredEmpfängertelefon im E.164-Format

textstringrequiredNachrichteninhalt (1–4 096 Zeichen)

fromstringoptionalAbsender-ID oder Nummer (Carrier-abhängig)

Alle SMS-Datensätze auflisten

bash

# Paginated list of all SMS records
curl -X POST https://api.novauth.com/api/v1/connect-hub/sms/sdr \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "page": 1,
    "rows_per_page": 20,
    "sort_by": "created_at",
    "sort_direction": "DESC"
  }'