세션 가져오기

`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`