Sandbox

Modalità Sandbox

Testa tutti e quattro i canali di verifica senza inviare messaggi reali, effettuare chiamate reali o sostenere costi. Passa dalla registrazione a un'integrazione funzionante in meno di cinque minuti.

✓Nessun messaggio reale inviato

✓Nessuna connessione all'operatore

✓Nessuna fatturazione

✓100 chiamate di test al giorno

1Ottieni le tue credenziali di test

Le chiavi API sandbox iniziano con sk_test_. Creane una dalla dashboard sotto Sandbox Keys. Usa la tua chiave sandbox con gli endpoint /sandbox dedicati — vedi gli esempi di codice nel Passaggio 3.

api key

production  BTEL_xxxxxxxxxxxxxxxx
sandbox     sk_test_xxxxxxxxxxxxxxxx

Le richieste sandbox vanno agli endpoint /sandbox dedicati (es. /call/flash/sandbox), non ai percorsi di produzione. Una chiave sk_test_ su un endpoint di produzione verrà rifiutata — usa sempre l'URL sandbox.

2Usa un numero di telefono di test

Qualsiasi numero nell'intervallo +1 555 000 xxxx è un numero di test. Ogni canale riconosce quattro numeri speciali con comportamenti distinti — vedi la tabella per canale nel Passaggio 3.

3Invia una verifica di test

Scegli un canale qui sotto. Ogni richiesta sandbox verso un numero di test risponde con un payload mock prevedibile — non vengono effettuate chiamate di rete reali.

Sostituisci sk_test_xxxxxxxxxxxxxxxx con la tua chiave sandbox effettiva dalla 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 — Risposta Sandbox

json

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

In sandbox la chiamata non viene mai effettuata. Il caller di risposta +15550482951 codifica l'OTP nelle ultime 6 cifre — la tua app legge 482951.

Numeri di test per Verify Call:

NumeroComportamentoStato

+15550000001Successo — l'ID chiamante +15550482951 codifica l'OTP 482951200

+15550000002Successo — nessun equivalente di errore sincrono per verify-call200

+15550000003Gateway SIP non connesso503

+15550000004Errore interno del server500

Segnala l'esito della verifica usando lo stesso webhook della produzione. Vedi l<link>avvio rapido del canale</link> per il passaggio webhook.

Limiti e fatturazione

Limite giornaliero100 verifiche di test su tutti i canali

FatturazioneMai addebitato — la sandbox è sempre gratuita

CanaliVerify Call, SMS, WhatsApp, OTP Telegram

Numeri di testIntervallo +1 555 000 xxxx — il comportamento varia per canale

Conservazione CDR7 giorni (come la produzione)

Quando superi il limite giornaliero, l'API restituisce 429 Too Many Requests con il messaggio Sandbox daily limit of N verifications reached. Resets at midnight UTC. Attendi fino alle 00:00 UTC o usa un account diverso.

Pronto per andare in produzione? Vedi i prezzi — sostituisci sk_test_ con la tua chiave BTEL_ e aggiorna i percorsi degli endpoint rimuovendo /sandbox.