Endpoints위젯
세션 업그레이드 URL 생성
iframe에 표시할 호스팅 세션 업그레이드 위젯의 URL을 반환합니다. `/session/upgrade`로 생성된 세션 업그레이드 챌린지의 보호자에게 제시하여, 새로 요청된 권한을 승인받습니다.
Authorization
api-key AuthorizationBearer <token>
In: header
Request Body
application/json
세션 업그레이드 URL 생성 요청
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://example.com/widget/generate-session-upgrade-url" \ -H "Content-Type: application/json" \ -d '{ "challengeId": "ae6d4729-af32-42ea-8ef2-ff46c7664802", "email": "parent@example.com" }'{ "url": "https://family.k-id.com/widget", "shortUrl": "https://family.k-id.com/s/12345678-1234-1234-1234-123456789012?pid=42&s=qr"}부모 동의 URL 생성 POST
iframe에 표시할 호스팅 보호자 동의 위젯의 URL을 반환합니다. 기존 챌린지의 보호자에게 제시하여 동의를 받습니다. `/challenge/send-email`이 연결하는 것과 동일한 경험이며, 링크를 직접 전달하려는 경우에 사용합니다.
위젯 상태 가져오기 GET
`/widget/generate-e2e-url` 또는 `/widget/generate-age-gate-url`이 반환한 `widgetId`를 키로 하여 엔드투엔드 또는 연령 게이트 위젯 흐름의 결과를 반환합니다. 위젯의 QR 코드를 스캔한 휴대폰 등 플레이어가 다른 기기에서 흐름을 완료하고 자체 서비스에서 그 결과가 필요할 때 사용하십시오. 위젯이 한 번 `PASS`를 보고하면 이후에도 계속 `PASS`를 보고합니다. 이어서 `/session/get`을 호출하여 세션의 현재 상태와 권한을 조회하십시오. 결과를 신속하게 알아야 한다면 자주 폴링하는 대신 웹훅을 구독하십시오.