Przejdź do treści głównej
ShieldID

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ą.

Co zmienia się między sandboxem a produkcją.
Prefiks kluczavk_sand_… identyfikuje klucz sandbox w momencie uwierzytelniania. Nie ma osobnego konta sandbox ani panelu do skonfigurowania.
Znacznik środowiskaKaż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.
RozliczeniaSesje sandbox nigdy nie są rozliczane, w żadnym planie, bez względu na liczbę sesji potrzebnych do zbudowania i przetestowania integracji.
Sama weryfikacjaPrawdziwa: 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ótce

Samoobsł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.