보호자 관리 세션 권한 업데이트
세션에서 보호자가 관리할 수 있는 권한을 업데이트합니다. 제품이 보호자에게 노출하지 않는 권한은 거부되지 않고 무시됩니다. 따라서 요청에 명시한 것보다 적은 수의 권한만 변경될 수 있습니다. 응답은 적용된 결과 권한 집합입니다. 요청이 그대로 반영되었다고 가정하지 말고 응답을 확인하십시오.
Authorization
api-key In: header
Request Body
application/json
세션 권한 업데이트 요청
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/session/set-guardian-managed-permissions" \ -H "Content-Type: application/json" \ -d '{ "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672", "enabledPermissions": [ "text-chat-public", "text-chat-private" ] }'{ "status": "PASS", "session": { "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672", "permissions": [ { "name": "text-chat-public", "enabled": false, "managedBy": "GUARDIAN" } ] }}{ "error": "NOT_FOUND", "errorMessage": "Session not found"}세션 가져오기 GET
`sessionId` 또는 제품과 함께 제공된 `kuid`로 식별되는 기존 세션을 반환합니다. `etag`를 전달하면 조건부 조회가 됩니다. 해당 etag가 발급된 이후 변경된 경우에만 세션이 반환되며, 변경되지 않았으면 `NOT_MODIFIED`로 응답합니다. 세션 전체를 다시 가져오지 말고 etag로 폴링하십시오. `ACTIVE` 상태는 플레이어가 제품의 요구 사항을 충족했음을 의미하며, 응답에는 현재 적용되는 권한이 포함됩니다. etag는 응답 전체를 대상으로 하며, 제품 및 관할 구역 구성에서 파생되는 `permissions`, `ageStatus`, `ageCategory` 필드도 포함합니다. 따라서 세션 자체가 업데이트되지 않았더라도 구성을 변경하면 etag가 바뀝니다.
세션에서 보호자 연결 해제 POST
`/invite-parent` 플로우로 이전에 연결된 플레이어 세션에서 보호자 연결을 해제합니다. 성공하면 세션에 저장된 보호자 설정값이 모두 삭제되고 `Session.Unlink` 웹훅이 발생합니다. 권한과 기존 플레이어 데이터는 그대로 유지됩니다. 이 API는 `sessionId`에 대해 멱등적입니다. 연결이 이미 해제된 뒤에 다시 호출하면 원래의 `unlinkedAt`과 함께 200을 반환합니다.