Trust Center
Vérifiez vos propres utilisateurs : pièces d'identité, correspondance faciale et vérifications d'entreprise.
Trois méthodes font depuis du code ce que fait la fenêtre Vérifier quelqu'un : ouvrir une session, lire une session et lister des sessions. Chacune agit sur le Trust Center du compte dont vous utilisez la clé d'API.
Ouvrez une session
Appelez verify_session_create. Envoyez level (de 1 à 4, 2 par défaut) et, si vous le souhaitez, votre propre external_ref (200 caractères au maximum). La réponse contient un session_id, un hosted_url à envoyer à la personne, et expires_at, soit 24 heures plus tard.
Envoyez le lien
Redirigez votre utilisateur vers hosted_url, ou envoyez-le-lui.
Lisez le résultat
Appelez verify_session_result avec le session_id. Elle renvoie le status, votre external_ref, les dates, et le result une fois la session terminée.
Ce qui détermine la session
- Le mode. Une session est un test quand le service fonctionne en mode test, et en direct quand il fonctionne en mode En direct. Les sessions de test sont gratuites, jamais comptées, et peuvent être terminées depuis le tableau de bord. Les liens en direct ne peuvent pas encore être menés à terme.
- Le niveau. Un niveau supérieur à ce que votre forfait autorise est refusé, avec le forfait qui le porte. La demande n'est jamais abaissée en silence.
- Au-delà de l'allocation. Une session en direct au-delà de l'allocation mensuelle de votre forfait est refusée sur Free, et sur un forfait payant elle est créée et marquée comme dépassement.
Les clés se créent dans Développeurs, et en créer une demande votre propre niveau 2.
Webhooks
À partir de Starter, définissez une adresse dans les paramètres de Trust Center et une requête signée est envoyée quand une vérification est tranchée, pour que vous n'ayez pas à interroger. Chacune porte un en-tête Xuda-Event et un en-tête Xuda-Signature composé d'un horodatage et d'un HMAC de l'horodatage et du corps, signé avec le secret affiché une seule fois dans les paramètres. Une livraison qui échoue est retentée, jusqu'à cinq tentatives.