Skip to main content
Créez une session de validation visuelle avant de téléverser des ressources liveness_face réutilisables. TokenLab utilise le format de l’API Action Volc et l’authentification Bearer TokenLab.

Point de terminaison et authentification

Les signatures AK/SK Volc ne sont pas acceptées. CallbackURL est obligatoire et doit être une URL HTTPS publique. ProjectName est facultatif et vaut default par défaut.

Déroulement

  1. Enregistrez Result.BytedToken, puis ouvrez Result.H5Link pour la personne à vérifier.
  2. Pour choisir la langue H5, ajoutez lng à H5Link, par exemple &lng=en. La langue n’est pas un champ du corps de la requête.
  3. À la fin du parcours H5, le navigateur ouvre Result.CallbackURL. La requête de callback peut contenir bytedToken, resultCode, algorithmBaseRespCode, reqMeasureInfoValue et verify_type.
  4. Interrogez Obtenir le résultat de validation visuelle avec le BytedToken enregistré jusqu’au retour de Result.GroupId.
BytedToken est valide 30 minutes et lié à l’organisation authentifiée ainsi qu’à ProjectName. Le lien H5 permet une seule validation terminée et devient invalide après utilisation. Traitez Result.H5Link comme une URL de navigateur opaque : ouvrez-la comme page de premier niveau, sans l’analyser, la décoder, la réécrire ni l’intégrer. TokenLab gère le transfert du navigateur et le pont de callback.

Exemple de requête

Exemple de réponse

Les erreurs utilisent la même structure racine. Lisez ResponseMetadata.Error.Code et ResponseMetadata.Error.Message, et non les champs d’erreur des autres API TokenLab /v1.