Endpoints위젯
세션 권한 관리 URL 생성
iframe에 표시할 호스팅 권한 관리 위젯의 URL을 반환합니다. 보호자가 이전에 세션에 부여한 권한을 다시 확인하고 변경할 수 있습니다. `email`은 해당 세션을 승인한 보호자와 일치해야 합니다.
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-manage-session-permissions-url" \ -H "Content-Type: application/json" \ -d '{ "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672", "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"}End-to-End URL 생성 POST
iframe에 표시할 호스팅 엔드투엔드 위젯의 URL을 반환합니다. 이 위젯은 연령 게이트와 그로 인해 발생하는 동의 챌린지까지 전체 흐름을 하나의 호스팅 경험으로 처리하므로, 개별 엔드포인트를 직접 조합하지 않고 단일 임베드로 대체할 수 있습니다. 이미 보유한 연령 신호(`kuid`, `age`, `dateOfBirth`)를 제공하면 위젯의 연령 수집 단계를 건너뛸 수 있습니다.
부모 동의 URL 생성 POST
iframe에 표시할 호스팅 보호자 동의 위젯의 URL을 반환합니다. 기존 챌린지의 보호자에게 제시하여 동의를 받습니다. `/challenge/send-email`이 연결하는 것과 동일한 경험이며, 링크를 직접 전달하려는 경우에 사용합니다.