Tạo phiên xác minh người thật

Tạo phiên xác minh liveness cho người thật và lấy trang thu thập dữ liệu trên thiết bị di động.

Sau khi tạo phiên xác minh liveness cho người thật, cần mở H5Link trong trình duyệt trên điện thoại và lưu BytedToken. Khi việc thu thập dữ liệu hoàn tất, trình duyệt sẽ chuyển hướng đến CallbackURL, nhưng callback thành công không có nghĩa là nhóm tư liệu người thật đã sẵn sàng.

Hãy hoàn tất việc thu thập dữ liệu và lấy kết quả xác minh trong vòng 10 phút. Nếu phiên hết hiệu lực, cần tạo lại; không tiếp tục sử dụng Token đã hết hạn.

POST/v1/assets/doubao/

Tạo phiên xác minh liveness. Cần mở H5Link trong trình duyệt trên điện thoại và lưu BytedToken để truy vấn kết quả cuối cùng.

Xác thực

bearerAuth

Xác thựcBearer <token>

Vị trí truyền: header

Tham số truy vấn

Action*"CreateVisualValidateSession"

Có giá trị cố định là CreateVisualValidateSession.

Giá trị mặc định"CreateVisualValidateSession"

Giá trị được phép

"CreateVisualValidateSession"

Version*"2024-01-01"

Phiên bản API, có giá trị cố định là 2024-01-01.

Giá trị mặc định"2024-01-01"

Giá trị được phép

"2024-01-01"

Nội dung yêu cầu

application/json

Định nghĩa kiểu TypeScript

Sử dụng kiểu request body trong TypeScript.

CallbackURL*string

URL callback của khách hàng sau khi xác minh hoàn tất.

Định dạnguri

ProjectName?string

Được nền tảng quản lý tập trung; giá trị được truyền không được sử dụng để phân chia phạm vi nghiệp vụ.

Nội dung phản hồi

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