Créer une session de validation visuelle

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.

Utilisez l’organisation authentifiée, l’utilisateur et le ProjectName sensible à la casse qui ont créé la session.

Ouvrez Result.H5Link immédiatement après la création de la session. Le délai du premier accès H5 peut expirer avant les 30 minutes de validité de BytedToken.

Point de terminaison et authentificationCopy Anchor Link

POST https://api.tokenlab.sh/api/v3?Action=CreateVisualValidateSession&Version=2024-01-01
Authorization: Bearer <TOKENLAB_API_KEY>
Content-Type: application/json

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éroulementCopy Anchor Link

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êteCopy Anchor Link

curl 'https://api.tokenlab.sh/api/v3?Action=CreateVisualValidateSession&Version=2024-01-01' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"CallbackURL":"https://yourapp.example.com/seedance/callback","ProjectName":"default"}'

Exemple de réponseCopy Anchor Link

{
  "ResponseMetadata": {
    "RequestId": "req_abc123",
    "Action": "CreateVisualValidateSession",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "BytedToken": "ZXhhbXBsZS10b2tlbg",
    "H5Link": "https://api.tokenlab.sh/api/v3/visual-validation/sessions/svv_example/h5?Version=2024-01-01",
    "CallbackURL": "https://yourapp.example.com/seedance/callback"
  }
}

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.

curl -X POST "https://example.com/api/v3" \  -H "Content-Type: application/json" \  -d '{    "CallbackURL": "http://example.com"  }'

{  "id": "string"}