TokenLab

Video & tư liệu

Lấy Kết quả Xác thực Trực quan

Lấy nhóm dữ liệu người thật được tạo ra bởi quá trình xác thực trực quan.

POST
/api/v3

Hãy thực hiện truy vấn (poll) Action này sau luồng xác thực trực quan H5. Kết quả thành công sẽ trả về ID nhóm dữ liệu TokenLab cho người đã được xác minh.

Sử dụng cùng tổ chức, người dùng và ProjectName phân biệt chữ hoa chữ thường đã được xác thực như khi tạo phiên làm việc.

Endpoint Và Xác thực

POST https://api.tokenlab.sh/api/v3?Action=GetVisualValidateResult&Version=2024-01-01
Authorization: Bearer <TOKENLAB_API_KEY>
Content-Type: application/json

Gửi BytedToken được trả về bởi Tạo Phiên Xác thực Trực quan. Nếu bạn đã đặt ProjectName trong quá trình tạo, hãy gửi cùng giá trị phân biệt chữ hoa chữ thường đó tại đây; nếu không, hãy bỏ qua hoặc sử dụng default.

Kết quả có thể chưa sẵn sàng ngay lập tức sau khi trình duyệt gọi lại (callback). Hãy thử lại yêu cầu cho đến khi Result.GroupId được trả về hoặc BytedToken 30 phút hết hạn. Việc lặp lại một yêu cầu thành công với cùng một token sẽ trả về cùng một GroupId đã được ánh xạ.

Sử dụng GroupId được trả về làm group_id khi tạo tài nguyên dữ liệu liveness_face.

Ví dụ Yêu cầu

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

Ví dụ Phản hồi

{
  "ResponseMetadata": {
    "RequestId": "req_def456",
    "Action": "GetVisualValidateResult",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "GroupId": "group-20260720123456-real1"
  }
}

Các lỗi sử dụng ResponseMetadata.Error.Code và ResponseMetadata.Error.Message. Phản hồi thành công chứa ResponseMetadata và Result; nó không sử dụng bao đóng phản hồi (response envelope) từ các API /v1 khác của TokenLab.

Trạng tháiMãNguyên nhân
400InvalidParameterBytedToken không hợp lệ hoặc đã hết hạn, ProjectName không khớp, hoặc quá trình xác minh chưa hoàn tất (hãy thử lại)
400InvalidVersionVersion không phải là 2024-01-01
405MethodNotAllowedAction này chỉ chấp nhận POST
409ConflictNhóm đã xác minh đã được ánh xạ tới một tổ chức khác
503ServiceUnavailableXác thực người thật không khả dụng hoặc yêu cầu thất bại; hãy thử lại sau
curl -X POST "https://example.com/api/v3" \  -H "Content-Type: application/json" \  -d '{    "CallbackURL": "http://example.com"  }'
{  "id": "string"}

Xác thực

BearerAuth
AuthorizationBearer <token>

Xác thực bằng Khóa API. Tạo hoặc quản lý khóa API trong Dashboard > API > API Keys.

Vị trí: header

Tham số truy vấn

Action?string

Giá trị hợp lệ

  • "CreateContentsGenerationsTasks"
  • "GetContentsGenerationsTask"
  • "ListContentsGenerationsTasks"
  • "DeleteContentsGenerationsTasks"
  • "CreateVisualValidateSession"
  • "GetVisualValidateResult"
  • "CreateAssetGroup"
  • "ListAssetGroups"
  • "GetAssetGroup"
  • "UpdateAssetGroup"
  • "DeleteAssetGroup"
  • "CreateAsset"
  • "ListAssets"
  • "GetAsset"
  • "UpdateAsset"
  • "DeleteAsset"
Version?string
mặc định"2024-01-01"

Header

X-TokenLab-Delivery-Policy?string

Chính sách phân phối theo yêu cầu. Ghi đè các mặc định của API key và Workspace. Tự động thử TokenLab Verified trước và có thể chuyển đổi một lần sang Official chỉ trước khi xuất, chấp nhận yêu cầu hoặc tạo tài nguyên cố định.

Giá trị hợp lệ

  • "auto"
  • "verified"
  • "official"

Nội dung yêu cầu

application/json

Phản hồi

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json