Endpoints연령 인증
연령 인증 요청 상태 조회
연령 인증 요청의 현재 상태를 반환합니다. 인증을 시작한 뒤 폴링하거나, 웹훅을 서버 측에서 확인하는 데 사용합니다. 요청은 `PENDING`에서 `IN_PROGRESS`로 진행되며 최종적으로 `PASS` 또는 `FAIL`로 확정됩니다. 확정된 요청에는 확인된 내용(추정 연령, 연령 카테고리, 사용된 방법)과, 실패한 경우 그 사유도 함께 담깁니다. `PASS`와 `FAIL` 외의 상태는 모두 진행 중으로 처리하십시오.
Authorization
api-key AuthorizationBearer <token>
In: header
Query Parameters
id*string
The ID of the age verification request
Match
^[A-z0-9]{8}-[A-z0-9]{4}-[A-z0-9]{4}-[A-z0-9]{4}-[A-z0-9]{12}$Format
uuidincludeDob?boolean
If set to true, includes the verified date of birth (dob) field in the response when available
Default
falseResponse Body
application/json
curl -X GET "https://example.com/age-verification/get-status?id=ae6d4729-af32-42ea-8ef2-ff46c7664802"{ "id": "ae6d4729-af32-42ea-8ef2-ff46c7664802", "status": "PASS", "age": { "low": 18, "high": 20 }, "ageCategory": "adult", "method": "id-document"}이메일 보내기 POST
챌린지의 세부 정보를 수신자에게 이메일로 발송합니다. 대부분 보호자에게 보내는 동의 요청에 사용됩니다. 챌린지는 이미 존재해야 하며, 이 API는 전달만 수행합니다. 다시 보내려면 한 번 더 호출하십시오.
접근 연령 인증 수행 POST
접근 연령 인증을 시작하고 iframe에 표시할 호스팅 URL을 반환합니다. 기존 세션을 업그레이드하는 것이 아니라, 확인된 연령을 기준으로 제품이나 기능에 대한 진입을 제한할 때 사용합니다. 플레이어는 반환된 URL에서 인증을 완료합니다. 결과는 `/age-verification/get-status` 또는 웹훅으로 확인하십시오.