TokenLab

視頻與素材

取得視覺驗證結果

取得由視覺驗證所產生的真人素材群組。

POST
/api/v3

在 H5 視覺驗證流程後輪詢此 Action。成功的回應會傳回該已驗證人員的 TokenLab 素材群組 ID。

請使用與建立工作階段時相同的已驗證組織、使用者以及區分大小寫的 ProjectName。

端點與驗證

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

傳送由 建立視覺驗證工作階段 所傳回的 BytedToken。若您在建立時設定了 ProjectName,請在此處傳送相同且區分大小寫的值;否則請省略它或使用 default。

結果可能不會在瀏覽器回呼後立即準備就緒。請重複嘗試相同的請求,直到傳回 Result.GroupId 或 30 分鐘的 BytedToken 過期為止。使用相同的 token 重複執行成功的請求,將會傳回相同的對應 GroupId。

在建立 liveness_face 素材資產時,請將傳回的 GroupId 用作 group_id。

請求範例

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

回應範例

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

錯誤訊息使用 ResponseMetadata.Error.Code 和 ResponseMetadata.Error.Message。成功的回應包含 ResponseMetadata 和 Result;它不使用 TokenLab 其他 /v1 API 的回應封裝格式。

狀態代碼原因
400InvalidParameterBytedToken 無效或已過期、ProjectName 不符,或驗證尚未完成(請重試)
400InvalidVersionVersion 不是 2024-01-01
405MethodNotAllowed此 Action 僅接受 POST
409Conflict已驗證的群組已對應至另一個組織
503ServiceUnavailable真人驗證服務不可用或請求失敗;請稍後重試
curl -X POST "https://example.com/api/v3" \  -H "Content-Type: application/json" \  -d '{    "CallbackURL": "http://example.com"  }'
{  "id": "string"}

授權

BearerAuth
AuthorizationBearer <token>

API Key 驗證。請在 Dashboard > API > API Keys 建立或管理 API 金鑰。

位置: header

查詢參數

Action?string

可選值

  • "CreateContentsGenerationsTasks"
  • "GetContentsGenerationsTask"
  • "ListContentsGenerationsTasks"
  • "DeleteContentsGenerationsTasks"
  • "CreateVisualValidateSession"
  • "GetVisualValidateResult"
  • "CreateAssetGroup"
  • "ListAssetGroups"
  • "GetAssetGroup"
  • "UpdateAssetGroup"
  • "DeleteAssetGroup"
  • "CreateAsset"
  • "ListAssets"
  • "GetAsset"
  • "UpdateAsset"
  • "DeleteAsset"
Version?string
預設值"2024-01-01"

請求標頭

X-TokenLab-Delivery-Policy?string

單次請求傳遞策略。會覆寫 API key 與 Workspace 的預設值。系統會自動優先嘗試 TokenLab Verified,並可能在輸出、請求接受或建立持久性資源前切換至 Official 模式一次。

可選值

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

請求主體

application/json

回應

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json