Sandbox

Sandbox-Modus

Alle vier Verifizierungskanäle testen, ohne echte Nachrichten zu senden, echte Anrufe zu tätigen oder Kosten zu verursachen. Von der Registrierung bis zur funktionierenden Integration in unter fünf Minuten.

✓Keine echten Nachrichten gesendet

✓Keine Carrier-Verbindungen

✓Keine Abrechnung

✓100 Testanrufe / Tag

1Testzugangsdaten holen

Sandbox-API-Schlüssel beginnen mit sk_test_. Erstelle einen im Dashboard unter Sandbox-Schlüssel. Verwende deinen Sandbox-Schlüssel mit den dedizierten /sandbox-Endpunkten – Codebeispiele findest du in Schritt 3.

api key

production  BTEL_xxxxxxxxxxxxxxxx
sandbox     sk_test_xxxxxxxxxxxxxxxx

Sandbox-Anfragen gehen an dedizierte /sandbox-Endpunkte (z. B. /call/flash/sandbox), nicht an die Produktionspfade. Ein sk_test_-Schlüssel an einem Produktions-Endpunkt wird abgelehnt – immer die Sandbox-URL verwenden.

2Eine Testtelefonnummer verwenden

Jede Nummer im Bereich +1 555 000 xxxx ist eine Testnummer. Jeder Kanal erkennt vier spezielle Nummern mit unterschiedlichen Verhaltensweisen – siehe die kanalspezifische Tabelle in Schritt 3.

3Eine Testverifizierung senden

Wähle unten einen Kanal. Jede Sandbox-Anfrage an eine Testnummer gibt einen vorhersehbaren Mock-Payload zurück – keine echten Netzwerkaufrufe werden getätigt.

Ersetze sk_test_xxxxxxxxxxxxxxxx durch deinen tatsächlichen Sandbox-Schlüssel aus dem Dashboard.

POST/api/v1/connect-hub/call/flash/sandbox

bash

curl -X POST https://api.novauth.com/api/v1/connect-hub/call/flash/sandbox \
  -H "x-api-key: sk_test_xxxxxxxxxxxxxxxx" \
  -H "x-account-id: YOUR_ACCOUNT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "callee":        "+15550000001",
    "max_ring_time": 20
  }'

200 OK — Sandbox-Antwort

json

{
  "uuid":    "test_fc_01JQHM7P3K2NX4Y8",
  "caller":  "+15550482951",
  "callee":  "+15550000001",
  "sandbox": true
}

In der Sandbox wird kein Anruf getätigt. Der Antwort-Caller +15550482951 kodiert den OTP in seinen letzten 6 Ziffern – deine App liest 482951.

Testnummern für Verify Call:

NummerVerhaltenStatus

+15550000001Erfolg — Anrufer-ID +15550482951 kodiert OTP 482951200

+15550000002Erfolg — kein Synchron-Fehler-Äquivalent für Verify Call200

+15550000003SIP-Gateway nicht verbunden503

+15550000004Interner Serverfehler500

Verifizierungsergebnis über denselben Webhook wie in der Produktion melden. Den Webhook-Schritt findest du im Kanal-Schnellstart.

Limits & Abrechnung

Tageslimit100 Testverifizierungen über alle Kanäle

AbrechnungKeine Kosten – Sandbox ist immer kostenlos

KanäleVerify Call, SMS, WhatsApp, Telegram-OTP

TestnummernBereich +1 555 000 xxxx – Verhalten variiert je Kanal

CDR-Aufbewahrung7 Tage (wie in der Produktion)

Wenn das Tageslimit überschritten wird, gibt die API 429 Too Many Requests mit der Meldung Sandbox daily limit of N verifications reached. Resets at midnight UTC. zurück. Bis 00:00 UTC warten oder ein anderes Konto verwenden.

Bereit für den Live-Betrieb? Preise ansehen – sk_test_ gegen deinen BTEL_-Schlüssel tauschen und die Endpunktpfade um /sandbox kürzen.