Endpointsセッション

セッションを削除する

セッションIDを指定してプレイヤーセッションを削除します。対象のセッションは呼び出し元のプロダクトに属している必要があります。 既定では論理削除です。セッションは revoked としてマークされ、以後クエリできなくなり、プレイヤーIDは再利用可能になりますが、レコード自体は保持されます。 **この操作は取り消せません。** `hardDelete` に `true` を指定した場合は、セッションとそれに含まれる同意情報を完全に削除します。元に戻すことはできません。ハード削除を明示的に有効化されたデベロッパーのみが利用できます。

POST
/session/delete
AuthorizationBearer <token>

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"  }'
Empty

デフォルト権限を取得する GET

保護者の同意が得られる前の状態で、プレイヤーがその管轄区域で既定で付与される権限を返します。 管轄区域とあわせて、`dateOfBirth`、`age`、`kuid` のうち最大1つを指定してください。複数を指定した場合は不正なリクエストになります。いずれも指定しない場合は、現在の日付をもとに年齢が算出されます。 何も保存されないため、年齢ゲートを実行する前にその管轄区域で何が許可されるかを確認する用途に適しています。

セッションを取得する GET

`sessionId`、またはプロダクトとあわせた `kuid` で指定した、既存のセッションを返します。 `etag` を指定すると条件付き取得になります。そのetagの発行後に変更があった場合のみセッションが返され、変更がない場合は `NOT_MODIFIED` が返されます。セッション全体を取得し直すのではなく、etagを使ってポーリングしてください。 `ACTIVE` はプレイヤーがプロダクトの要件を満たしていることを意味し、レスポンスには現在有効な権限が含まれます。 etagはレスポンス全体を対象としており、プロダクトと管轄区域の設定から導出される `permissions`、`ageStatus`、`ageCategory` も含みます。そのため、セッション自体が更新されていなくても、設定を変更するとetagは変わります。