新しいセッションと権限ガイドおよびドキュメントの更新
セッションと権限を管理するための包括的なガイドを追加し、重要な説明を追加してコアコンセプトのドキュメントを更新しました。
新機能
新しいガイド: セッションと権限の管理
新しいクイックスタートガイドを追加しました: セッションと権限の管理。このガイドでは、次の手順を説明しています:
- Webhookとセッション比較を使用した権限変更の検出
- セッション削除と取り消しの処理
- プレイヤーへの権限変更の通知
- 権限アップグレードフローの実装
- チャレンジがセッションとどのように関連するかの理解
このガイドは、親が設定を変更したり、プレイヤーが年齢アップしたりするなど、時間の経過とともに権限の変更に対応する必要がある統合に不可欠です。
ドキュメントの更新
セッションドキュメント
セッションコンセプトページに重要な説明を追加しました:
- セッションIDの永続性: プレイヤーはプロダクトごとに正確に1つのセッションを持ちます。セッションIDは権限変更を通じて永続しますが、セッションが取り消され、同意フローが再度完了した場合は新しいセッションIDが作成されます。
- セッション削除の動作: 削除されたセッションは、エラーコード
NOT_FOUNDでHTTP 400を返します（404ではありません）。これは意図的なものです—削除されたセッションは、存在しなかったかのように扱う必要があります。 - 年齢アップの変更: 年齢アップイベントはWebhook通知をトリガーしません。これらの変更を検出するには、セッション比較を使用する必要があります。
権限ドキュメント
権限コンセプトページを次の内容で強化しました:
managedByフィールドの変更:managedByは時間の経過とともに変更される可能性があることを明確にしました（たとえば、プレイヤーが年齢アップしたときにGUARDIANからPLAYERに）。- プレイヤー管理の権限: プレイヤーが
/session/upgradeAPIを介してPLAYER管理の権限を有効にすることをリクエストすると、Challengeを作成せずに自動的に有効になります。 - 権限アップグレードのコンテンツ: 権限アップグレードのドキュメントを、より見つけやすくするために権限ページに統合しました。
変更内容
ドキュメントの統合
- 権限アップグレードコンセプトページを権限ページに統合しました。すべての参照を新しい場所に更新しました。
次のステップ
- 新しいセッションと権限の管理ガイドを確認してください
- 統合がセッション削除を正しく処理していることを確認してください（
NOT_FOUNDでHTTP 400）
これらの更新についてご質問がある場合や、統合に関するサポートが必要な場合は、サポートチームまでお気軽にお問い合わせください。