メインコンテンツに移動

32件の投稿件のタグ「changelog」を含む

すべてのタグを見る

新しいセッションと権限ガイドおよびドキュメントの更新

セッションと権限を管理するための包括的なガイドを追加し、重要な説明を追加してコアコンセプトのドキュメントを更新しました。

新機能​

新しいガイド: セッションと権限の管理​

新しいクイックスタートガイドを追加しました: セッションと権限の管理。このガイドでは、次の手順を説明しています:

  • Webhookとセッション比較を使用した権限変更の検出
  • セッション削除と取り消しの処理
  • プレイヤーへの権限変更の通知
  • 権限アップグレードフローの実装
  • チャレンジがセッションとどのように関連するかの理解

このガイドは、親が設定を変更したり、プレイヤーが年齢アップしたりするなど、時間の経過とともに権限の変更に対応する必要がある統合に不可欠です。

ドキュメントの更新​

セッションドキュメント​

セッションコンセプトページに重要な説明を追加しました:

  • セッションIDの永続性: プレイヤーはプロダクトごとに正確に1つのセッションを持ちます。セッションIDは権限変更を通じて永続しますが、セッションが取り消され、同意フローが再度完了した場合は新しいセッションIDが作成されます。
  • セッション削除の動作: 削除されたセッションは、エラーコードNOT_FOUNDでHTTP 400を返します（404ではありません）。これは意図的なものです—削除されたセッションは、存在しなかったかのように扱う必要があります。
  • 年齢アップの変更: 年齢アップイベントはWebhook通知をトリガーしません。これらの変更を検出するには、セッション比較を使用する必要があります。

権限ドキュメント​

権限コンセプトページを次の内容で強化しました:

  • managedByフィールドの変更: managedByは時間の経過とともに変更される可能性があることを明確にしました（たとえば、プレイヤーが年齢アップしたときにGUARDIANからPLAYERに）。
  • プレイヤー管理の権限: プレイヤーが/session/upgrade APIを介してPLAYER管理の権限を有効にすることをリクエストすると、Challengeを作成せずに自動的に有効になります。
  • 権限アップグレードのコンテンツ: 権限アップグレードのドキュメントを、より見つけやすくするために権限ページに統合しました。

変更内容​

ドキュメントの統合​

  • 権限アップグレードコンセプトページを権限ページに統合しました。すべての参照を新しい場所に更新しました。

次のステップ​

  • 新しいセッションと権限の管理ガイドを確認してください
  • 統合がセッション削除を正しく処理していることを確認してください（NOT_FOUNDでHTTP 400）

これらの更新についてご質問がある場合や、統合に関するサポートが必要な場合は、サポートチームまでお気軽にお問い合わせください。

チェンジログの導入

新しいチェンジログセクションの導入をお知らせします！これは、開発者向けインターフェース、APIの動作、統合パターンの変更についてお知らせする一元化された場所として機能します。

新機能​

チェンジログセクション​

本日より、開発者向けの変更に関する更新を1つの便利な場所で確認できます。定期的に更新を投稿し、以下についてお知らせします：

  • APIの更新と変更: 新しいエンドポイント、パラメータの変更、非推奨事項
  • イベントシステムの更新: DOMイベントとWebhookの変更
  • インターフェースと動作の変更: 開発者向けインターフェースと統合パターンの更新
  • 破壊的変更: 統合に影響を与える可能性のある重要な更新

検証イベント契約​

すべての検証結果データのフォーマット方法に関する信頼できるリファレンス資料を開発者に提供するため、検証イベント契約を導入します。この契約はDOMイベントとWebhookの両方に適用され、統合のための安定したリファレンスとして維持することをお約束します。

これが意味すること：​

  • 一貫したイベント構造: すべてのイベントタイプで予測可能なイベントペイロード
  • 包括的なドキュメント: 統合を容易にする完全なイベントスキーマと例
  • 信頼できるリファレンス: 検証結果データのフォーマットに関する安定したリファレンス資料として、この契約を維持することをお約束します

イベント構造と統合での使用方法の詳細については、イベントドキュメントを参照してください。

最新情報を確認​

このチェンジログをブックマークして定期的に確認するか、更新を購読してk-IDプラットフォームの最新の変更について常に情報を得てください。統合に影響を与える可能性のあるすべての更新について、お知らせすることをお約束します。

高レベルのプロダクト発表や機能リリースについては、リリースノートをご覧ください。

更新を購読​

お好みのフィード形式でチェンジログを購読できます：

これらのフィードURLのいずれかをRSSリーダー、ニュースアグリゲーター、または監視ツールに追加すると、新しいチェンジログエントリが公開されたときに自動通知を受け取ることができます。

これらの更新についてご質問がある場合や、統合に関するサポートが必要な場合は、サポートチームまでお気軽にお問い合わせください。

これはチェンジログの最初のエントリです。開発者向けインターフェースと動作が変更される際は、引き続きここに更新を投稿します。