Vidéo & ressources
Obtenir le résultat de la validation visuelle
Récupère le groupe de matériel de personne réelle produit par la validation visuelle.
Interrogez cette Action après le flux de validation visuelle H5. Un résultat réussi renvoie l'ID du groupe de matériel TokenLab pour la personne vérifiée.
Utilisez la même organisation authentifiée, le même utilisateur et le même ProjectName sensible à la casse que ceux utilisés lors de la création de la session.
Point de terminaison et authentification
POST https://api.tokenlab.sh/api/v3?Action=GetVisualValidateResult&Version=2024-01-01
Authorization: Bearer <TOKENLAB_API_KEY>
Content-Type: application/jsonEnvoyez le BytedToken renvoyé par Créer une session de validation visuelle. Si vous avez défini ProjectName lors de la création, envoyez la même valeur sensible à la casse ici ; sinon, omettez-le ou utilisez default.
Le résultat peut ne pas être prêt immédiatement après le rappel du navigateur. Réessayez la même requête jusqu'à ce que Result.GroupId soit renvoyé ou que le BytedToken de 30 minutes expire. La répétition d'une requête réussie avec le même jeton renvoie le même GroupId mappé.
Utilisez le GroupId renvoyé comme group_id lors de la création d'actifs matériels liveness_face.
Exemple de requête
curl 'https://api.tokenlab.sh/api/v3?Action=GetVisualValidateResult&Version=2024-01-01' \
-H "Authorization: Bearer $TOKENLAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"BytedToken":"ZXhhbXBsZS10b2tlbg","ProjectName":"default"}'Exemple de réponse
{
"ResponseMetadata": {
"RequestId": "req_def456",
"Action": "GetVisualValidateResult",
"Version": "2024-01-01",
"Service": "ark",
"Region": "cn-beijing"
},
"Result": {
"GroupId": "group-20260720123456-real1"
}
}Les erreurs utilisent ResponseMetadata.Error.Code et ResponseMetadata.Error.Message. Une réponse réussie contient ResponseMetadata et Result ; elle n'utilise pas l'enveloppe de réponse des autres API /v1 de TokenLab.
| Statut | Code | Cause |
|---|---|---|
400 | InvalidParameter | BytedToken est invalide ou expiré, ProjectName ne correspond pas, ou la vérification n'est pas encore terminée (réessayer) |
400 | InvalidVersion | Version n'est pas 2024-01-01 |
405 | MethodNotAllowed | L'Action accepte uniquement POST |
409 | Conflict | Le groupe vérifié est déjà mappé à une autre organisation |
503 | ServiceUnavailable | La validation de personne réelle est indisponible ou la requête a échoué ; réessayez plus tard |
curl -X POST "https://example.com/api/v3" \ -H "Content-Type: application/json" \ -d '{ "CallbackURL": "http://example.com" }'{ "id": "string"}Autorisation
BearerAuth Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.
Emplacement: header
Paramètres de requête
Valeurs possibles
- "CreateContentsGenerationsTasks"
- "GetContentsGenerationsTask"
- "ListContentsGenerationsTasks"
- "DeleteContentsGenerationsTasks"
- "CreateVisualValidateSession"
- "GetVisualValidateResult"
- "CreateAssetGroup"
- "ListAssetGroups"
- "GetAssetGroup"
- "UpdateAssetGroup"
- "DeleteAssetGroup"
- "CreateAsset"
- "ListAssets"
- "GetAsset"
- "UpdateAsset"
- "DeleteAsset"
"2024-01-01"En-têtes
Politique de livraison par requête. Remplace les valeurs par défaut de la clé API et de l'espace de travail. Tente automatiquement TokenLab Verified en premier et peut basculer une fois vers Official uniquement avant la sortie, l'acceptation de la requête ou la création de ressource persistante.
Valeurs possibles
- "auto"
- "verified"
- "official"
Corps de la requête
application/json
Réponse
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json