删除会话
按会话 ID 删除玩家会话。该会话必须属于调用方产品。 默认为软删除:会话被标记为已撤销,不再可查询,其玩家 ID 可重新使用,但记录本身会保留。 **不可撤销。** 若将 `hardDelete` 设为 `true`,则会永久删除该会话及其内嵌的同意信息,此操作无法恢复。仅对明确启用了硬删除的开发者可用。
Authorization
api-key In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://example.com/session/delete" \ -H "Content-Type: application/json" \ -d '{ "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672" }'{ "error": "NOT_FOUND", "errorMessage": "Session not found"}获取默认权限 GET
返回玩家在其司法管辖区默认会获得的权限,即尚未取得监护人同意之前的权限。 请在提供司法管辖区的同时,最多提供 `dateOfBirth`、`age` 或 `kuid` 中的一个;提供多个会导致请求无效。三者都不提供时,将按当前日期计算玩家年龄。 该接口不会保存任何数据,因此适合在执行年龄验证之前预览某个司法管辖区允许哪些行为。
获取会话 GET
返回既有会话,可通过 `sessionId`,或通过 `kuid` 与产品一起进行标识。 传入 `etag` 可将读取变为条件式:仅当会话在该 etag 签发之后发生变化时才会返回,未变化时则响应 `NOT_MODIFIED`。请使用 etag 轮询,而不要反复获取完整会话。 状态为 `ACTIVE` 表示玩家满足该产品的要求,响应中会包含当前对其生效的权限。 etag 覆盖整个响应,包括根据产品和司法管辖区配置得出的 `permissions`、`ageStatus` 和 `ageCategory` 字段,因此即使会话本身未被更新,配置变更也会使 etag 发生变化。