Sandbox
Chiavi API sandbox per la verifica dell'identità.
Una chiave sandbox esegue lo stesso identico flusso di API, pagina ospitata e webhook della produzione, con una chiave che non viene mai fatturata. È il modo più rapido per capire se ShieldID fa al caso Suo prima di parlare di prezzi.
Come funziona
Stessa pipeline. Chiave diversa. Nessuna fattura.
La sandbox non è una modalità demo semplificata: è la vera pipeline di verifica, regolata esclusivamente dalla chiave che Lei invia.
| Prefisso della chiave | vk_sand_… identifica una chiave sandbox nel momento dell'autenticazione. Non c'è alcun account o dashboard sandbox separato da configurare. |
|---|---|
| Contrassegno dell'ambiente | Ogni sessione, risultato e webhook creato con una chiave sandbox riporta environment: "sandbox", così nulla di ciò che nasce in sandbox può essere scambiato a valle per una verifica reale. |
| Fatturazione | Le sessioni sandbox non vengono mai fatturate, su ogni piano, per tutte le sessioni necessarie a sviluppare e testare la Sua integrazione. |
| La verifica in sé | Reale: il Suo documento, il Suo volto, gli stessi controlli. Non esiste un set separato di documenti di prova falsi: Lei verifica la Sua identità per vedere come si comporta il prodotto. |
Come ottenere una chiave
Ne richieda una oggi. Il self-service arriverà presto.
La creazione self-service di chiavi sandbox sui piani idonei è prevista ma non ancora pianificata. Fino al rilascio, una richiesta tramite il modulo di contatto Le consente di ottenere direttamente una chiave.
Oggi
Ci racconti brevemente cosa sta sviluppando nel modulo di contatto e Le rilasceremo una chiave sandbox: la maggior parte delle richieste viene evasa lo stesso giorno lavorativo.
A breve
ProssimamenteLa creazione self-service di chiavi sandbox, sui piani idonei, è prevista ma non ancora pianificata, così può generare una chiave non appena si registra.
Provi di persona
Scenari di test che può eseguire sul Suo telefono.
Nessun documento falso necessario: li esegua con il Suo documento d'identità per vedere come si comporta realmente ogni percorso.
Un esito positivo
Crei una sessione, apra la pagina ospitata, fotografi il Suo documento d'identità e completi la prova di liveness. Osservi checks.document, checks.liveness, checks.antispoof e checks.face_match restituire ciascuno PASS.
Una fotocamera rifiutata
Neghi il permesso della fotocamera quando la pagina ospitata lo richiede. La sessione si conclude con FAILED e un failure_reason su cui può costruire un vero messaggio di errore.
Un nuovo tentativo dopo il fallimento (prossimamente)
Riaprire il verification_url di una sessione FAILED per riportarla a PENDING per un secondo tentativo non è ancora disponibile. Oggi consideri FAILED come stato finale: crei una nuova sessione se il richiedente vuole riprovare.
Una sessione scaduta
Crei una sessione e non la tocchi. Trascorsa la finestra predefinita passa a EXPIRED, senza dati su persona o controlli: uno stato ideale per testare i messaggi di timeout della Sua interfaccia.
Una sessione annullata
Chiami DELETE /v1/sessions/{id} su una sessione PENDING, quindi provi ad aprire verification_url. Verifichi che la Sua app tratti una sessione annullata come conclusa, non come un errore.
Lingua francese
Crei una sessione con locale: "fr" e verifichi che la pagina ospitata e la Sua gestione del return-URL siano corrette per un richiedente francofono.
Limiti
Cosa non fa la sandbox.
Risposte chiare, non clausole in piccolo.
- La sandbox non ha un limite di frequenza separato dalla produzione: al momento nessuna richiesta è limitata dai limiti del piano, perché tale applicazione non è ancora attiva.
- Sandbox e produzione sono separate unicamente dal prefisso della chiave, non da account, dashboard o set di documenti distinti.
- Una sessione sandbox è una verifica reale di un documento reale. Non usi il documento di qualcun altro per testare: verifichi il Suo.
Domande
FAQ sulla sandbox.
Ottenere una chiave
Richieda una chiave sandbox.
Ci dica cosa sta sviluppando e Le forniremo una chiave per iniziare a testare.
Le sessioni sandbox non vengono mai fatturate.