Создать сеанс проверки человека

Создание сеанса проверки живого человека и получение страницы захвата данных на мобильном устройстве.

После создания сеанса проверки живого человека откройте H5Link в браузере телефона и сохраните BytedToken. После завершения захвата данных браузер перейдёт на CallbackURL, но успешный callback не означает готовность группы ресурсов реального человека.

Завершите захват данных и получите результат проверки в течение 10 минут. После истечения срока сеанса создайте новый; не используйте истёкший Token повторно.

POST/v1/assets/doubao/

Создайте сеанс проверки живого человека. Откройте H5Link в браузере телефона и сохраните BytedToken для получения итогового результата.

Аутентификация

bearerAuth

АутентификацияBearer <token>

Расположение: header

Параметры строки запроса

Action*"CreateVisualValidateSession"

Всегда CreateVisualValidateSession.

По умолчанию"CreateVisualValidateSession"

Допустимые значения

"CreateVisualValidateSession"

Version*"2024-01-01"

Версия API, всегда 2024-01-01.

По умолчанию"2024-01-01"

Допустимые значения

"2024-01-01"

Тело запроса

application/json

Определения типов TypeScript

Используйте тип request body в TypeScript.

CallbackURL*string

Адрес callback клиента после завершения проверки.

Форматuri

ProjectName?string

Управляется централизованно платформой; переданное значение не используется для разделения бизнес-данных.

Тело ответа

`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"
  }
}