Sandbox
Klucze API sandbox do weryfikacji tożsamości.
Klucz sandbox uruchamia identyczny przepływ API, strony hostowanej i webhooków jak produkcja, na kluczu, który nigdy nie jest rozliczany. To najszybszy sposób, aby przekonać się, czy ShieldID Państwu odpowiada, zanim zaczną Państwo rozmowy o cenach.
Jak to działa
Ten sam potok. Inny klucz. Bez faktury.
Sandbox nie jest uproszczonym trybem demonstracyjnym — to prawdziwy potok weryfikacji, rozróżniany wyłącznie tym, jaki klucz Państwo wyślą.
| Prefiks klucza | vk_sand_… identyfikuje klucz sandbox w momencie uwierzytelniania. Nie ma osobnego konta sandbox ani panelu do skonfigurowania. |
|---|---|
| Znacznik środowiska | Każda sesja, wynik i webhook utworzone kluczem sandbox zawierają environment: "sandbox", dzięki czemu nic utworzonego w sandbox nie może zostać pomylone z prawdziwą weryfikacją w dalszych systemach. |
| Rozliczenia | Sesje sandbox nigdy nie są rozliczane, w żadnym planie, bez względu na liczbę sesji potrzebnych do zbudowania i przetestowania integracji. |
| Sama weryfikacja | Prawdziwa: Państwa własny dokument, Państwa własna twarz, te same kontrole. Nie ma osobnego zestawu fałszywych dokumentów testowych — weryfikują Państwo samych siebie, aby zobaczyć, jak produkt się zachowuje. |
Uzyskanie klucza
Proszę poprosić o klucz już dziś. Samoobsługa wkrótce.
Samoobsługowe tworzenie kluczy sandbox w kwalifikujących się planach jest planowane, lecz nie ma jeszcze terminu. Do czasu wdrożenia klucz otrzymają Państwo bezpośrednio, składając prośbę przez formularz kontaktowy.
Dziś
Proszę napisać w formularzu kontaktowym, co Państwo budują, a przygotujemy klucz sandbox — większość próśb realizujemy tego samego dnia roboczego.
Wkrótce
WkrótceSamoobsługowe tworzenie kluczy sandbox w kwalifikujących się planach jest planowane, lecz nie ma jeszcze terminu, dzięki czemu mogą Państwo wygenerować klucz zaraz po rejestracji.
Proszę spróbować samodzielnie
Scenariusze testowe, które mogą Państwo uruchomić na własnym telefonie.
Fałszywe dokumenty nie są potrzebne — proszę uruchomić te scenariusze na własnym dokumencie tożsamości, aby zobaczyć, jak naprawdę zachowuje się każda ścieżka.
Pomyślne przejście
Proszę utworzyć sesję, otworzyć stronę hostowaną, sfotografować własny dokument tożsamości i ukończyć test żywotności. Zobaczą Państwo, jak checks.document, checks.liveness, checks.antispoof i checks.face_match zwracają PASS.
Odrzucona zgoda na aparat
Proszę odmówić zgody na dostęp do aparatu, gdy poprosi o to strona hostowana. Sesja kończy się statusem FAILED z failure_reason, na którym można oprzeć prawdziwy komunikat o błędzie.
Ponowna próba po niepowodzeniu (wkrótce)
Ponowne otwarcie verification_url sesji FAILED w celu zresetowania jej do PENDING na potrzeby drugiej próby nie jest jeszcze dostępne. Obecnie FAILED należy traktować jako stan końcowy — jeśli wnioskodawca chce spróbować ponownie, proszę utworzyć nową sesję.
Wygasła sesja
Proszę utworzyć sesję i niczego w niej nie robić. Po upływie domyślnego czasu przechodzi w stan EXPIRED, bez danych osoby i kontroli — to dobry stan do testowania komunikatów o przekroczeniu czasu w Państwa interfejsie.
Anulowana sesja
Proszę wywołać DELETE /v1/sessions/{id} dla sesji PENDING, a następnie spróbować otworzyć verification_url. Proszę upewnić się, że Państwa aplikacja traktuje anulowaną sesję jako zakończoną, a nie jako błąd.
Francuska wersja językowa
Proszę utworzyć sesję z locale: "fr" i sprawdzić, czy strona hostowana oraz Państwa własna obsługa return-URL wyglądają poprawnie dla wnioskodawcy francuskojęzycznego.
Ograniczenia
Czego sandbox nie robi.
Proste odpowiedzi, bez drobnego druku.
- Sandbox nie ma osobnego limitu zapytań względem produkcji — obecnie żadne żądanie nie jest ograniczane limitami wynikającymi z planu; to egzekwowanie nie jest jeszcze uruchomione.
- Sandbox i produkcja są rozdzielone wyłącznie prefiksem klucza, a nie osobnymi kontami, panelami ani zestawami dokumentów.
- Sesja sandbox to prawdziwa weryfikacja prawdziwego dokumentu. Proszę nie używać do testów cudzego dokumentu tożsamości — proszę zweryfikować własny.
Pytania
FAQ do sandboxa.
Uzyskanie klucza
Prośba o klucz sandbox.
Proszę napisać, co Państwo budują, a przekażemy klucz, aby mogli Państwo zacząć testy.
Sesje w sandboxie nigdy nie są rozliczane.