Trust Center
Weryfikuj własnych użytkowników: dokumenty tożsamości, porównanie twarzy i sprawdzenie firm.
Trzy metody robią z kodu to, co okno Zweryfikuj osobę: otwierają sesję, odczytują sesję i wyświetlają sesje. Każda działa na Trust Center konta, którego klucza API używasz.
Otwórz sesję
Wywołaj verify_session_create. Wyślij level (od 1 do 4, domyślnie 2) i, jeśli chcesz, własne external_ref (najwyżej 200 znaków). Odpowiedź zawiera session_id, hosted_url, który wysyłasz osobie, i expires_at, czyli 24 godziny później.
Wyślij link
Przekieruj użytkownika na hosted_url albo mu go wyślij.
Odczytaj wynik
Wywołaj verify_session_result z session_id. Zwraca status, Twoje external_ref, czasy oraz result, gdy sesja jest zakończona.
Co decyduje o sesji
- Tryb. Sesja jest testowa, gdy usługa działa w trybie testowym, i live, gdy działa w Live. Sesje testowe są bezpłatne, nigdy nie są liczone i można je zakończyć z dashboardu. Linków live nie można jeszcze ukończyć.
- Poziom. Poziom wyższy, niż pozwala Twój plan, jest odrzucany z informacją, który plan go ma. Żądanie nigdy nie jest po cichu obniżane.
- Ponad limit. Sesja live ponad miesięczny limit planu jest odrzucana w planie Bezpłatnie, a w planie płatnym zostaje utworzona i oznaczona jako nadwyżka.
Klucze tworzy się w Developers, a do ich utworzenia potrzebujesz własnego Poziomu 2.
Webhooki
W planie Starter i wyższych ustaw adres w ustawieniach Trust Center, a podpisane żądanie zostanie wysłane, gdy weryfikacja zostanie rozstrzygnięta, więc nie musisz odpytywać. Każde niesie nagłówek Xuda-Event i nagłówek Xuda-Signature złożony ze znacznika czasu i HMAC znacznika czasu oraz treści, podpisanego sekretem pokazanym raz w ustawieniach. Nieudana dostawa jest ponawiana, do pięciu prób.