获取会话

返回既有会话，可通过 `sessionId`，或通过 `kuid` 与产品一起进行标识。传入 `etag` 可将读取变为条件式：仅当会话在该 etag 签发之后发生变化时才会返回，未变化时则响应 `NOT_MODIFIED`。请使用 etag 轮询，而不要反复获取完整会话。状态为 `ACTIVE` 表示玩家满足该产品的要求，响应中会包含当前对其生效的权限。 etag 覆盖整个响应，包括根据产品和司法管辖区配置得出的 `permissions`、`ageStatus` 和 `ageCategory` 字段，因此即使会话本身未被更新，配置变更也会使 etag 发生变化。

Authorization

api-key

AuthorizationBearer <token>

In: header

Query Parameters

sessionId?string

玩家会话的会话ID

Match^[A-z0-9]{8}-[A-z0-9]{4}-[A-z0-9]{4}-[A-z0-9]{4}-[A-z0-9]{12}$

Formatuuid

kuid?string

玩家的k-ID用户ID。

Match^[A-z0-9]{8}-[A-z0-9]{4}-[A-z0-9]{4}-[A-z0-9]{4}-[A-z0-9]{12}$

Formatuuid

etag?string

先前会话响应中的etag

Response Body

`application/json`

curl -X GET "https://example.com/session/get"

{  "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672",  "kuid": "12b9fa0e-6d6d-4903-a1fc-f2233027b71d",  "ageStatus": "LEGAL_ADULT",  "ageCategory": "adult",  "etag": "e889efb9e8a985308e82bed78c5aef7f37f50cf36b7337bf654980d0bab7a574",  "status": "ACTIVE",  "dateOfBirth": "2005-04-15",  "jurisdiction": "US-CA",  "managedBy": "PLAYER",  "permissions": [    {      "name": "text-chat-public",      "enabled": false,      "managedBy": "GUARDIAN"    },    {      "name": "text-chat-private",      "enabled": true,      "managedBy": "PLAYER"    },    {      "name": "forums",      "enabled": false,      "managedBy": "PROHIBITED"    }  ],  "allowances": [    {      "name": "3516-7b2e",      "numericalValue": 5,      "type": "numerical"    },    {      "name": "63d3-90ac",      "selectionValue": "733c-ca11",      "type": "selection"    }  ]}

{  "error": "NOT_FOUND",  "errorMessage": "Session not found"}

获取会话

Authorization

Query Parameters

Response Body

200application/json

304

400application/json

`application/json`

`application/json`