Tạo phiên xác thực trực quan

Tạo phiên xác thực trực quan trước khi tải lên tư liệu liveness_face có thể tái sử dụng. TokenLab dùng định dạng Action API của Volc và xác thực Bearer của TokenLab.

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

Mở Result.H5Link ngay sau khi tạo phiên. Hạn mở H5 lần đầu có thể kết thúc trước thời hạn 30 phút của BytedToken.

Endpoint và xác thựcCopy Anchor Link

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

Không chấp nhận chữ ký AK/SK của Volc. CallbackURL là trường bắt buộc và phải là URL HTTPS công khai. ProjectName là trường tùy chọn, mặc định là default.

Quy trìnhCopy Anchor Link

1. Lưu Result.BytedToken và mở Result.H5Link cho người cần xác thực.
2. Để chọn ngôn ngữ H5, thêm lng vào H5Link, ví dụ &lng=en. Ngôn ngữ không phải là trường trong nội dung yêu cầu.
3. Sau khi quy trình H5 hoàn tất, trình duyệt sẽ mở Result.CallbackURL. Truy vấn callback có thể chứa bytedToken, resultCode, algorithmBaseRespCode, reqMeasureInfoValue và verify_type.
4. Thăm dò Lấy kết quả xác thực trực quan bằng BytedToken đã lưu cho đến khi trả về Result.GroupId.

BytedToken có hiệu lực trong 30 phút và gắn với tổ chức đã xác thực cùng ProjectName. Liên kết H5 chỉ cho phép hoàn tất một lần xác thực và sẽ hết hiệu lực sau khi sử dụng.

Hãy coi Result.H5Link là URL trình duyệt không trong suốt: mở URL này dưới dạng trang cấp cao nhất và không phân tích, giải mã, viết lại hoặc nhúng URL. TokenLab quản lý việc chuyển giao trình duyệt và cầu nối callback.

Ví dụ yêu cầuCopy Anchor Link

curl 'https://api.tokenlab.sh/api/v3?Action=CreateVisualValidateSession&Version=2024-01-01' \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"CallbackURL":"https://yourapp.example.com/seedance/callback","ProjectName":"default"}'

Ví dụ phản hồiCopy Anchor Link

{
  "ResponseMetadata": {
    "RequestId": "req_abc123",
    "Action": "CreateVisualValidateSession",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "BytedToken": "ZXhhbXBsZS10b2tlbg",
    "H5Link": "https://api.tokenlab.sh/api/v3/visual-validation/sessions/svv_example/h5?Version=2024-01-01",
    "CallbackURL": "https://yourapp.example.com/seedance/callback"
  }
}

Lỗi dùng cùng cấu trúc cấp cao nhất. Hãy đọc ResponseMetadata.Error.Code và ResponseMetadata.Error.Message thay vì các trường lỗi của những API /v1 khác của TokenLab.

curl -X POST "https://example.com/api/v3" \  -H "Content-Type: application/json" \  -d '{    "CallbackURL": "http://example.com"  }'

{  "id": "string"}