비디오 및 자료
시각적 검증 결과 가져오기
시각적 검증을 통해 생성된 실제 인물 머티리얼 그룹을 가져옵니다.
H5 시각적 검증 흐름 이후 이 Action을 폴링(Poll)하십시오. 성공적인 결과는 검증된 인물에 대한 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이 만료될 때까지 동일한 요청을 재시도하십시오. 동일한 토큰으로 성공적인 요청을 반복하면 동일하게 매핑된 GroupId가 반환됩니다.
반환된 GroupId를 liveness_face 머티리얼 에셋을 생성할 때 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에서 사용하는 응답 엔벨로프는 사용하지 않습니다.
| 상태 | 코드 | 원인 |
|---|---|---|
400 | InvalidParameter | BytedToken이 유효하지 않거나 만료됨, ProjectName이 일치하지 않음, 또는 검증이 아직 완료되지 않음(재시도 필요) |
400 | InvalidVersion | Version이 2024-01-01이 아님 |
405 | MethodNotAllowed | 해당 Action은 POST만 허용함 |
409 | Conflict | 검증된 그룹이 이미 다른 조직에 매핑됨 |
503 | ServiceUnavailable | 실제 인물 검증을 사용할 수 없거나 요청 실패; 나중에 재시도 |
curl -X POST "https://example.com/api/v3" \ -H "Content-Type: application/json" \ -d '{ "CallbackURL": "http://example.com" }'{ "id": "string"}인증
BearerAuth API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.
위치: header
쿼리 매개변수
허용 값
- "CreateContentsGenerationsTasks"
- "GetContentsGenerationsTask"
- "ListContentsGenerationsTasks"
- "DeleteContentsGenerationsTasks"
- "CreateVisualValidateSession"
- "GetVisualValidateResult"
- "CreateAssetGroup"
- "ListAssetGroups"
- "GetAssetGroup"
- "UpdateAssetGroup"
- "DeleteAssetGroup"
- "CreateAsset"
- "ListAssets"
- "GetAsset"
- "UpdateAsset"
- "DeleteAsset"
"2024-01-01"헤더
요청별 전송 정책입니다. API 키 및 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