Sandbox
Sandbox-API-sleutels voor identiteitsverificatie.
Een sandbox-sleutel draait dezelfde API, gehoste pagina en webhook-flow als productie, op een sleutel die nooit wordt gefactureerd. Het is de snelste manier om te zien of ShieldID bij u past voordat u over prijzen praat.
Hoe het werkt
Dezelfde pipeline. Andere sleutel. Geen factuur.
Sandbox is geen vereenvoudigde demomodus. Het is de echte verificatiepipeline, die uitsluitend wordt bepaald door de sleutel die u meestuurt.
| Sleutelprefix | vk_sand_… identificeert een sandbox-sleutel op het moment dat u zich authenticeert. Er is geen apart sandbox-account of dashboard om in te stellen. |
|---|---|
| Omgevingsstempel | Elke sessie, elk resultaat en elke webhook die met een sandbox-sleutel is aangemaakt, bevat environment: "sandbox", zodat niets wat in de sandbox is aangemaakt verderop voor een echte verificatie kan worden aangezien. |
| Facturatie | Sandbox-sessies worden nooit gefactureerd, bij elk abonnement, voor zoveel sessies als u nodig hebt om uw integratie te bouwen en te testen. |
| De verificatie zelf | Echt: uw eigen document, uw eigen gezicht, dezelfde controles. Er is geen aparte set nepdocumenten om mee te testen. U verifieert uzelf om te zien hoe het product zich gedraagt. |
Een sleutel verkrijgen
Vraag er vandaag een aan. Self-service komt eraan.
Zelf sandbox-sleutels aanmaken bij in aanmerking komende abonnementen is gepland, maar nog niet ingepland. Tot die tijd krijgt u via het contactformulier rechtstreeks een sleutel.
Vandaag
Vertel ons via het contactformulier kort wat u bouwt, dan leveren wij een sandbox-sleutel af, de meeste aanvragen nog dezelfde werkdag.
Binnenkort
Binnenkort beschikbaarZelf sandbox-sleutels aanmaken, bij in aanmerking komende abonnementen, is gepland maar nog niet ingepland, zodat u een sleutel kunt genereren zodra u zich aanmeldt.
Probeer het zelf
Testscenario's die u op uw eigen telefoon kunt uitvoeren.
Geen nepdocumenten nodig: voer deze uit met uw eigen ID om te zien hoe elk pad zich daadwerkelijk gedraagt.
Een foutloze doorloop
Maak een sessie aan, open de gehoste pagina, fotografeer uw eigen ID en voltooi de liveness-controle. Zie hoe checks.document, checks.liveness, checks.antispoof en checks.face_match elk PASS teruggeven.
Een geweigerde camera
Weiger de cameratoestemming wanneer de gehoste pagina erom vraagt. De sessie eindigt op FAILED met een failure_reason waaromheen u een echte foutmelding kunt bouwen.
Een nieuwe poging na mislukking (binnenkort beschikbaar)
De verification_url van een FAILED-sessie opnieuw openen om die voor een tweede poging terug te zetten naar PENDING is nog niet beschikbaar. Behandel FAILED op dit moment als eindstatus en maak een nieuwe sessie aan als de aanvrager het opnieuw wil proberen.
Een verlopen sessie
Maak een sessie aan en laat die ongemoeid. Na het standaardtijdvak gaat ze naar EXPIRED, zonder persoons- of controlegegevens. Een goede status om de time-outmeldingen van uw UI te testen.
Een geannuleerde sessie
Roep DELETE /v1/sessions/{id} aan op een PENDING-sessie en probeer vervolgens de verification_url te openen. Controleer of uw app een geannuleerde sessie als afgerond behandelt, niet als een fout.
Franse taalinstelling
Maak een sessie aan met locale: "fr" en controleer of de gehoste pagina en uw eigen afhandeling van de return-URL goed leesbaar zijn voor een Franstalige aanvrager.
Beperkingen
Wat sandbox niet doet.
Duidelijke antwoorden, geen kleine lettertjes.
- Sandbox heeft geen aparte rate limit ten opzichte van productie. Er wordt momenteel geen enkel verzoek afgeremd door limieten op abonnementsniveau; die handhaving is nog niet actief.
- Sandbox en productie zijn uitsluitend gescheiden via de sleutelprefix, niet via aparte accounts, dashboards of documentsets.
- Een sandbox-sessie is een echte verificatie van een echt document. Gebruik niet het ID van iemand anders om te testen: verifieer uw eigen ID.
Vragen
Veelgestelde vragen over de sandbox.
Een sleutel aanvragen
Vraag een sandbox-sleutel aan.
Vertel ons wat u bouwt, dan zorgen wij voor een sleutel waarmee u kunt beginnen met testen.
Sandbox-sessies worden nooit gefactureerd.