실제 인물 확인 결과 조회

확인 세션 생성 시 반환된 BytedToken으로 실제 인물 자료 그룹 ID를 가져옵니다. Result.GroupId가 비어 있으면 촬영이 아직 완료되지 않았다는 의미이며 Token이 유효하지 않거나 만료되면 확인 세션을 다시 생성해야 합니다.

실제 인물 자료 그룹 생성 후 플랫폼 업데이트 API로 이름과 설명을 보완할 수 있습니다. 이후 업로드하는 자료는 확인된 얼굴과 일치해야 합니다.

POST/v1/assets/doubao/

BytedToken으로 확인 결과를 가져옵니다. Result.GroupId가 비어 있으면 촬영이 아직 완료되지 않았다는 의미입니다.

인증

bearerAuth

인증Bearer <token>

전달 위치: header

쿼리 매개변수

Action*"GetVisualValidateResult"

GetVisualValidateResult로 고정됩니다.

기본값"GetVisualValidateResult"

허용 값

"GetVisualValidateResult"

Version*"2024-01-01"

API 버전이며 2024-01-01로 고정됩니다.

기본값"2024-01-01"

허용 값

"2024-01-01"

요청 본문

application/json

TypeScript 타입 정의

TypeScript에서 request body 타입을 사용하세요.

BytedToken*string

확인 세션 생성 시 반환된 Token입니다.

ProjectName?string

플랫폼에서 통합 관리하며 전달한 값은 비즈니스 분할에 사용하지 않습니다.

응답 본문

`application/json`

curl -X POST "https://example.com/v1/assets/doubao/?Action=GetVisualValidateResult&Version=2024-01-01" \
  -H "Content-Type: application/json" \
  -d '{
    "BytedToken": "202608071652256191D5DA0C813A641759"
  }'

{
  "ResponseMetadata": {
    "RequestId": "20260807165320CFJCJ",
    "Action": "GetVisualValidateResult",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "xx-xxxxxx"
  },
  "Result": {
    "GroupId": "group-20260807165320-cfjcj"
  }
}