Endpoints会话
设置由监护人管理的会话权限
更新会话中允许监护人管理的权限。 产品未向监护人开放的权限会被忽略而不是被拒绝，因此一次请求实际变更的权限可能少于请求中列出的数量。响应是变更后的权限集合，请读取响应确认，不要假定请求已被完全照原样应用。
Authorization
api-key AuthorizationBearer <token>
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` webhook。权限和已有的玩家数据保持不变。 本接口对 `sessionId` 幂等。在关联已被解除后再次调用，会返回 200 及原来的 `unlinkedAt`。