Bac à sable

Mode bac à sable

Testez les quatre canaux de vérification sans envoyer de vrais messages, passer de vrais appels ni engager de frais. Passez de l'inscription à une intégration fonctionnelle en moins de cinq minutes.

✓Aucun vrai message envoyé

✓Aucune connexion opérateur

✓Aucune facturation

✓100 appels de test / jour

1Obtenez vos identifiants de test

Les clés API bac à sable commencent par sk_test_. Créez-en une depuis le tableau de bord sous Clés bac à sable. Utilisez votre clé bac à sable avec les endpoints /sandbox dédiés — consultez les exemples de code à l<link>Étape 3</link>.

api key

production  BTEL_xxxxxxxxxxxxxxxx
sandbox     sk_test_xxxxxxxxxxxxxxxx

Les requêtes bac à sable vont vers des endpoints /sandbox dédiés (par ex. /call/flash/sandbox), pas vers les chemins de production. Une clé sk_test_ sur un endpoint de production sera rejetée — utilisez toujours l'URL bac à sable.

2Utilisez un numéro de téléphone de test

Tout numéro dans la plage +1 555 000 xxxx est un numéro de test. Chaque canal reconnaît quatre numéros spéciaux avec des comportements distincts — consultez le tableau par canal à l<link>Étape 3</link>.

3Envoyez une vérification de test

Choisissez un canal ci-dessous. Chaque requête bac à sable vers un numéro de test répond avec une charge utile simulée prévisible — aucun appel réseau réel n'est effectué.

Remplacez sk_test_xxxxxxxxxxxxxxxx par votre clé bac à sable réelle du tableau de bord.

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 — Réponse bac à sable

json

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

En mode bac à sable, l'appel n'est jamais passé. L'appelant de réponse +15550482951 encode l'OTP dans ses 6 derniers chiffres — votre application lit 482951.

Numéros de test pour Verify Call:

NuméroComportementStatut

+15550000001Success — l'ID d'appelant +15550482951 encode l'OTP 482951200

+15550000002Success — pas d'équivalent d'échec synchrone pour verify-call200

+15550000003Passerelle SIP non connectée503

+15550000004Erreur interne du serveur500

Signalez le résultat de vérification en utilisant le même webhook qu'en production. Consultez le démarrage rapide du canal pour l'étape webhook.

Limites et facturation

Limite quotidienne100 vérifications de test tous canaux confondus

FacturationJamais facturé — le bac à sable est toujours gratuit

CanauxVerify Call, SMS, WhatsApp, OTP Telegram

Numéros de testPlage +1 555 000 xxxx — le comportement varie selon le canal

Rétention CDR7 jours (identique à la production)

Lorsque vous dépassez la limite quotidienne, l'API retourne 429 Too Many Requests avec le message Sandbox daily limit of N verifications reached. Resets at midnight UTC. Attendez jusqu'à 00:00 UTC ou utilisez un autre compte.

Prêt à passer en production ? Voir les tarifs — remplacez sk_test_ par votre clé BTEL_ et mettez à jour les chemins d'endpoints pour supprimer /sandbox.