TokenLab

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.

POST
/api/v3

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/json

Envoyez 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.

StatutCodeCause
400InvalidParameterBytedToken est invalide ou expiré, ProjectName ne correspond pas, ou la vérification n'est pas encore terminée (réessayer)
400InvalidVersionVersion n'est pas 2024-01-01
405MethodNotAllowedL'Action accepte uniquement POST
409ConflictLe groupe vérifié est déjà mappé à une autre organisation
503ServiceUnavailableLa 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
AuthorizationBearer <token>

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

Action?string

Valeurs possibles

  • "CreateContentsGenerationsTasks"
  • "GetContentsGenerationsTask"
  • "ListContentsGenerationsTasks"
  • "DeleteContentsGenerationsTasks"
  • "CreateVisualValidateSession"
  • "GetVisualValidateResult"
  • "CreateAssetGroup"
  • "ListAssetGroups"
  • "GetAssetGroup"
  • "UpdateAssetGroup"
  • "DeleteAssetGroup"
  • "CreateAsset"
  • "ListAssets"
  • "GetAsset"
  • "UpdateAsset"
  • "DeleteAsset"
Version?string
par défaut"2024-01-01"

En-têtes

X-TokenLab-Delivery-Policy?string

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