세션 삭제

세션 ID로 플레이어 세션을 삭제합니다. 대상 세션은 호출한 제품에 속해 있어야 합니다. 기본 동작은 논리 삭제입니다. 세션은 revoked로 표시되어 더 이상 조회되지 않고 플레이어 ID는 재사용할 수 있게 되지만, 레코드 자체는 보존됩니다. **되돌릴 수 없습니다.** `hardDelete`를 `true`로 지정하면 세션과 그 안에 포함된 동의 정보를 영구적으로 삭제하며, 이는 복구할 수 없습니다. 하드 삭제가 명시적으로 활성화된 개발자만 사용할 수 있습니다.

Authorization

api-key

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

sessionId*string

The session ID to delete

Formatuuid

hardDelete?boolean

Set to true to permanently and irreversibly delete the session instead of soft-deleting it. Omit, or set to false, for the default, reversible soft delete. Available only to developers explicitly enabled for hard delete.

essentialDependencies?string

What should happen when the product being deleted is essential to other products the same player still holds.

Omitting this field preserves existing behavior, and always will. It is equivalent to ignore.

ignore (default) - delete only the addressed session. Products that depend on it keep their sessions, which may leave them without the consent basis they relied on.
block - refuse the delete while the player still holds an active product that depends on this one, and name those products in the error. Use this when you want the API to protect you from stranding a dependent.
cascade - delete the dependent sessions as well, then the addressed session. Available only to developers explicitly enabled for it, because it removes sessions you did not name. It must also be called with a server-side API key: a client access token issued through /auth/issue-token is refused with UNAUTHORIZED, since this mode permanently removes sessions in other products. ignore and block accept either credential.

Value in

"ignore"
"block"
"cascade"

Response Body

`application/json`

curl -X POST "https://example.com/session/delete" \  -H "Content-Type: application/json" \  -d '{    "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672"  }'

Empty

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

세션 삭제

Authorization

Request Body

Response Body

200

400application/json

Example Not found

Example Not enabled

Example Dependents exist

`application/json`