Créer une session de vérification de personne réelle

Créez une session de vérification de présence réelle et obtenez la page de capture mobile.

Après la création d’une session de vérification de présence réelle, ouvrez H5Link dans un navigateur sur téléphone et conservez BytedToken. À la fin de la capture, le navigateur redirige vers CallbackURL, mais un callback réussi ne signifie pas que le groupe de ressources de personne réelle est prêt.

Terminez la capture et obtenez le résultat de vérification dans les 10 minutes. Si la session expire, créez-en une nouvelle et ne réutilisez pas un Token expiré.

POST/v1/assets/doubao/

Créez une session de vérification de présence réelle. Ouvrez H5Link dans un navigateur sur téléphone et conservez BytedToken pour consulter le résultat final.

Authentification

bearerAuth

AuthentificationBearer <token>

Emplacement: header

Paramètres de requête URL

Action*"CreateVisualValidateSession"

La valeur est CreateVisualValidateSession.

Valeur par défaut"CreateVisualValidateSession"

Valeurs autorisées

"CreateVisualValidateSession"

Version*"2024-01-01"

Version de l’API, dont la valeur est 2024-01-01.

Valeur par défaut"2024-01-01"

Valeurs autorisées

"2024-01-01"

Corps de requête

application/json

Définitions TypeScript

Utilisez le type request body en TypeScript.

CallbackURL*string

URL de callback du client après la fin de la vérification.

Formaturi

ProjectName?string

Géré de manière centralisée par la plateforme ; la valeur transmise n’est pas utilisée pour le partitionnement métier.

Corps de réponse

`application/json`

curl -X POST "https://example.com/v1/assets/doubao/?Action=CreateVisualValidateSession&Version=2024-01-01" \  -H "Content-Type: application/json" \  -d '{    "CallbackURL": "https://example.com/liveness/callback"  }'

{
  "ResponseMetadata": {
    "RequestId": "20260807165225A641759",
    "Action": "CreateVisualValidateSession",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "xx-xxxxxx"
  },
  "Result": {
    "BytedToken": "202608071652256191D5DA0C813A641759",
    "H5Link": "https://example.com/mobile/liveness-face/authorization",
    "CallbackURL": "https://example.com/liveness/callback"
  }
}