Sandbox
Sandbox-API-Schlüssel für die Identitätsprüfung.
Ein Sandbox-Schlüssel führt denselben API-, Hosted-Page- und Webhook-Ablauf wie in der Produktion aus, mit einem Schlüssel, der nie abgerechnet wird. So sehen Sie am schnellsten, ob ShieldID zu Ihnen passt, bevor Sie über Preise sprechen.
So funktioniert es
Dieselbe Pipeline. Anderer Schlüssel. Keine Rechnung.
Die Sandbox ist kein vereinfachter Demo-Modus, sondern die echte Verifizierungspipeline, die allein durch den gesendeten Schlüssel unterschieden wird.
| Schlüsselpräfix | vk_sand_… kennzeichnet beim Authentifizieren einen Sandbox-Schlüssel. Es gibt kein separates Sandbox-Konto und kein eigenes Dashboard, das Sie konfigurieren müssten. |
|---|---|
| Umgebungskennzeichnung | Jede Session, jedes Ergebnis und jeder Webhook, die mit einem Sandbox-Schlüssel erstellt werden, tragen environment: "sandbox". So kann nichts, was in der Sandbox erstellt wurde, nachgelagert mit einer echten Verifizierung verwechselt werden. |
| Abrechnung | Sandbox-Sessions werden in jedem Tarif nie abgerechnet, und zwar so viele, wie Sie zum Entwickeln und Testen Ihrer Integration benötigen. |
| Die Verifizierung selbst | Echt: Ihr eigenes Dokument, Ihr eigenes Gesicht, dieselben Prüfungen. Es gibt keinen separaten Satz gefälschter Testdokumente. Sie verifizieren sich selbst, um zu sehen, wie sich das Produkt verhält. |
Einen Schlüssel erhalten
Fordern Sie heute einen an. Self-Service folgt.
Die Self-Service-Erstellung von Sandbox-Schlüsseln in qualifizierten Tarifen ist geplant, aber noch nicht terminiert. Bis dahin erhalten Sie über das Kontaktformular direkt einen Schlüssel.
Heute
Erzählen Sie uns im Kontaktformular kurz, was Sie entwickeln, und wir stellen Ihnen einen Sandbox-Schlüssel aus, die meisten Anfragen noch am selben Werktag.
Demnächst
Demnächst verfügbarDie Self-Service-Erstellung von Sandbox-Schlüsseln in qualifizierten Tarifen ist geplant, aber noch nicht terminiert, damit Sie direkt bei der Anmeldung einen Schlüssel erzeugen können.
Probieren Sie es selbst aus
Testszenarien, die Sie auf Ihrem eigenen Smartphone durchspielen können.
Es werden keine gefälschten Dokumente benötigt. Führen Sie diese Szenarien mit Ihrem eigenen Ausweis durch, um zu sehen, wie sich jeder Pfad tatsächlich verhält.
Ein sauberer Durchlauf
Erstellen Sie eine Session, öffnen Sie die gehostete Seite, fotografieren Sie Ihren eigenen Ausweis und absolvieren Sie die Liveness-Prüfung. Beobachten Sie, wie checks.document, checks.liveness, checks.antispoof und checks.face_match jeweils mit PASS zurückkommen.
Eine abgelehnte Kamera
Verweigern Sie die Kameraberechtigung, wenn die gehostete Seite danach fragt. Die Session endet mit FAILED und einer failure_reason, anhand derer Sie eine sinnvolle Fehlermeldung erstellen können.
Ein erneuter Versuch nach einem Fehlschlag (demnächst verfügbar)
Das erneute Öffnen der verification_url einer FAILED-Session, um sie für einen zweiten Versuch auf PENDING zurückzusetzen, ist noch nicht verfügbar. Behandeln Sie FAILED derzeit als Endzustand und erstellen Sie eine neue Session, wenn die antragstellende Person es erneut versuchen möchte.
Eine abgelaufene Session
Erstellen Sie eine Session und lassen Sie sie unberührt. Nach Ablauf des Standardzeitfensters wechselt sie zu EXPIRED, ohne Personen- oder Prüfdaten. Ein guter Zustand, um die Timeout-Meldungen Ihrer Oberfläche zu testen.
Eine abgebrochene Sitzung
Rufen Sie DELETE /v1/sessions/{id} für eine PENDING-Sitzung auf und versuchen Sie dann, die verification_url zu öffnen. Prüfen Sie, ob Ihre App eine abgebrochene Sitzung als abgeschlossen behandelt und nicht als Fehler.
Französische Sprachversion
Erstellen Sie eine Session mit locale: "fr" und prüfen Sie, ob die gehostete Seite und Ihre eigene Verarbeitung der Return-URL für eine französischsprachige antragstellende Person korrekt funktionieren.
Einschränkungen
Was die Sandbox nicht leistet.
Klare Antworten statt Kleingedrucktem.
- Die Sandbox hat kein vom Produktivsystem getrenntes Ratenlimit. Derzeit wird keine Anfrage durch Limits des Tarifs gedrosselt, diese Durchsetzung ist noch nicht aktiv.
- Sandbox und Produktion werden ausschließlich durch das Schlüsselpräfix getrennt, nicht durch separate Konten, Dashboards oder Dokumentensätze.
- Eine Sandbox-Session ist eine echte Verifizierung eines echten Dokuments. Verwenden Sie zum Testen nicht den Ausweis einer anderen Person, sondern verifizieren Sie Ihren eigenen.
Fragen
FAQ zur Sandbox.
Schlüssel erhalten
Einen Sandbox-Schlüssel anfordern.
Erzählen Sie uns, was Sie entwickeln, und wir stellen Ihnen einen Schlüssel für den Teststart bereit.
Sandbox-Sitzungen werden nie abgerechnet.