실제 인물 확인 세션 생성

실제 인물 라이브니스 확인 세션을 생성하고 모바일 촬영 페이지를 가져옵니다.

실제 인물 라이브니스 확인 세션을 생성한 뒤 휴대전화 브라우저에서 H5Link를 열고 BytedToken을 저장해야 합니다. 촬영 완료 후 브라우저는 CallbackURL로 이동하지만 callback 성공이 실제 인물 자료 그룹의 준비 완료를 의미하지는 않습니다.

10분 안에 촬영을 완료하고 확인 결과를 가져오세요. 세션이 만료되면 다시 생성해야 하며 만료된 Token을 계속 재사용하지 마세요.

POST/v1/assets/doubao/

라이브니스 확인 세션을 생성합니다. 휴대전화 브라우저에서 H5Link를 열고 최종 결과 조회를 위해 BytedToken을 저장해야 합니다.

인증

bearerAuth

인증Bearer <token>

전달 위치: header

쿼리 매개변수

Action*"CreateVisualValidateSession"

CreateVisualValidateSession으로 고정됩니다.

기본값"CreateVisualValidateSession"

허용 값

"CreateVisualValidateSession"

Version*"2024-01-01"

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

기본값"2024-01-01"

허용 값

"2024-01-01"

요청 본문

application/json

TypeScript 타입 정의

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

CallbackURL*string

확인 완료 후 고객 callback 주소입니다.

형식uri

ProjectName?string

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

응답 본문

`application/json`

curl -X POST "https://example.com/v1/assets/doubao/?Action=CreateVisualValidateSession&Version=2024-01-01" \
  -H "Content-Type: application/json" \
  -d '{
    "CallbackURL": "https://example.com/liveness/callback"
  }'

{
  "ResponseMetadata": {
    "RequestId": "20260807165225A641759",
    "Action": "CreateVisualValidateSession",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "xx-xxxxxx"
  },
  "Result": {
    "BytedToken": "202608071652256191D5DA0C813A641759",
    "H5Link": "https://example.com/mobile/liveness-face/authorization",
    "CallbackURL": "https://example.com/liveness/callback"
  }
}

실제 인물 확인 세션 생성

인증

쿼리 매개변수

요청 본문

응답 본문

200application/json

400

401

404

503

5XX

`application/json`