Webhooksイベントタイプ
Session.Delete
セッションが削除されたときに発行されます。
このイベントの後、セッションは存在しなくなります。/session/get は NOT_FOUND で HTTP 400 を返し、プレイヤーがアクセスを取り戻すには年齢ゲートをもう一度完了する必要があります。
セッションが終了するそれぞれのケースへの対応は、セッションのライフサイクル全体の一部として、セッションと権限の管理を参照してください。
セッションはさまざまな理由で終了する可能性があります。revocation オブジェクトに、誰がなぜ終了したかが示されます:
actor | reason | 発生するタイミング |
|---|---|---|
parent | access-revoked-by-parent | 保護者が Family Connect でプロダクトへのすべてのアクセスを取り消した |
developer | deleted-by-developer | お客様のインテグレーションが /session/delete でセッションを削除した |
developer | erased-by-developer | お客様のインテグレーションが hardDelete: true でセッションを削除した |
developer | essential-product-deleted | 依存先の必須プロダクトのセッションが essentialDependencies: cascade で削除された |
これらの値は今後増える可能性があります
k-ID は新しい actor、reason、evidence のキーをいつでも追加する可能性があります。revocation の内容にかかわらず、すべての Session.Delete を「このプレイヤーにはセッションがない」として扱ってください。actor と reason での分岐は既知の値に対してのみ行い、それ以外は無視してください。
フィールド
| フィールド | タイプ | 必須 | 説明 |
|---|---|---|---|
eventType | string | はい | 常に"Session.Delete" |
data | object | はい | セッション削除データ |
data.id | string (UUID) | はい | セッションID |
data.productId | number | はい | プロダクトID |
data.revocation | object | いいえ | 誰がなぜセッションを終了したか |
data.revocation.actor | string | はい | セッションを終了した主体。例:parent、developer |
data.revocation.reason | string | はい | セッションが終了した理由。例:access-revoked-by-parent |
data.revocation.evidence | object | いいえ | 理由の詳細(文字列値)。下記を参照 |
証拠
reason | 証拠のキー |
|---|---|
essential-product-deleted | causeSessionId:依存先の削除されたセッション。causeProductId:そのセッションのプロダクト |
その他の理由には、現時点では evidence はありません。
例
{
"eventType": "Session.Delete",
"data": {
"id": "2d064cf7-0726-4193-b19a-8bd387937e60",
"productId": 42,
"revocation": {
"actor": "parent",
"reason": "access-revoked-by-parent"
}
}
}