Age Gate WidgetエンドポイントにredirectUrlをオプションパラメータとして追加しました。
/widget/generate-age-gate-urlエンドポイントは、optionsオブジェクト内にオプションのredirectUrlパラメータをサポートするようになりました。これにより、Age Gate Widget完了後にリダイレクトするURLを指定できます。これは、エンドツーエンドウィジェットエンドポイントと同様です。
redirectUrlパラメータは、HTTP/HTTPS URLまたはカスタムプロトコルスキームを使用したモバイルディープリンクをサポートします。
検証ドキュメントを更新し、メソッドフィールドの説明を改善し、ガイダンスを明確にしました。
Verification.Result Webhookドキュメントを更新しました:
ageCategoryは常に存在し、生の年齢値ではなくアクセス制御の決定に使用すべきであることを明確化self-confirmationとemail-confirmationを削除age-estimation-scanの説明を更新し、年齢範囲を返す顔年齢推定スキャン（DOBなし）であることを示すようにしました年齢確認とVPCフローのウィジェットUIをいつ閉じるかを明確にし、MegaWidgetOptionsスキーマにredirectUrlサポートを追加しました。
年齢確認とVPCフローのUIをいつ閉じるかを判断するシグナルとして、Widget.ExitReviewを使用することを明確にするためにドキュメントを更新しました。
更新されたドキュメント:
Widget.ExitReviewをリッスンするガイダンスを追加Widget.ExitReviewをリッスンするガイダンスを追加Widget.ExitReviewをリッスンするガイダンスを追加すべての言語バージョン（英語、日本語、簡体字中国語、韓国語）がこの明確化で更新されました。
MegaWidgetOptionsスキーマに、年齢確認リクエストスキーマと一貫性のあるredirectUrlサポートが含まれるようになりました。これにより、エンドツーエンドウィジェットを使用する際にリダイレクトURLを指定できます。
更新されたスキーマ:
MegaWidgetOptionsに#/components/schemas/RedirectUrlへの参照を持つredirectUrlフィールドが含まれるようになりましたこの変更は、すべてのOpenAPI仕様ファイル（英語、日本語、簡体字中国語、韓国語）で利用できます。
Compliance Studioのプロダクト画像の推奨アスペクト比と解像度を追加しました:
年齢データが利用可能な場合、Verification.Result WebhookイベントのFAILステータスイベントにageCategoryフィールドが含まれるように更新しました。
ageCategoryフィールドは、次の条件を満たす場合、Verification.Result WebhookイベントのFAILステータスに含まれるようになりました:
failureReasonがage-criteria-not-metage.lowとage.highの両方が存在）これにより、年齢基準を満たさないために検証が失敗した場合でも、ユーザーの年齢カテゴリに関するより完全な情報が提供され、明確なアクセス制御の境界を維持しながら、より優れた分析とログ記録が可能になります。
Verification.Resultドキュメントがこの変更を反映するように更新されました:
ageCategoryが存在するタイミングを明確にするために説明を更新ageCategoryが存在するタイミングを明確化ageCategoryを「場合によって含まれる」として表示するように更新ageCategoryを「sometimes²」として表示するように更新ageCategoryを追加ageCategoryを処理するためのガイダンスを更新ageCategoryの動作を明確化ageCategoryが存在する場合でも、アクセス制御の決定に決して使用しないでください。アクセスを決定するには、常にstatusフィールドを使用してください。ageCategoryを処理するように統合を更新してくださいageCategoryを使用しないでください。分析、ログ記録、または情報提供の目的でのみ使用してください。セッションと権限を管理するための包括的なガイドを追加し、重要な説明を追加してコアコンセプトのドキュメントを更新しました。
新しいクイックスタートガイドを追加しました: セッションと権限の管理。このガイドでは、次の手順を説明しています:
このガイドは、親が設定を変更したり、プレイヤーが年齢アップしたりするなど、時間の経過とともに権限の変更に対応する必要がある統合に不可欠です。
セッションコンセプトページに重要な説明を追加しました:
NOT_FOUNDでHTTP 400を返します（404ではありません）。これは意図的なものです—削除されたセッションは、存在しなかったかのように扱う必要があります。権限コンセプトページを次の内容で強化しました:
managedByフィールドの変更: managedByは時間の経過とともに変更される可能性があることを明確にしました（たとえば、プレイヤーが年齢アップしたときにGUARDIANからPLAYERに）。/session/upgrade APIを介してPLAYER管理の権限を有効にすることをリクエストすると、Challengeを作成せずに自動的に有効になります。NOT_FOUNDでHTTP 400）これらの更新についてご質問がある場合や、統合に関するサポートが必要な場合は、サポートチームまでお気軽にお問い合わせください。
新しいチェンジログセクションの導入をお知らせします！これは、開発者向けインターフェース、APIの動作、統合パターンの変更についてお知らせする一元化された場所として機能します。
本日より、開発者向けの変更に関する更新を1つの便利な場所で確認できます。定期的に更新を投稿し、以下についてお知らせします：
すべての検証結果データのフォーマット方法に関する信頼できるリファレンス資料を開発者に提供するため、検証イベント契約を導入します。この契約はDOMイベントとWebhookの両方に適用され、統合のための安定したリファレンスとして維持することをお約束します。
イベント構造と統合での使用方法の詳細については、イベントドキュメントを参照してください。
このチェンジログをブックマークして定期的に確認するか、更新を購読してk-IDプラットフォームの最新の変更について常に情報を得てください。統合に影響を与える可能性のあるすべての更新について、お知らせすることをお約束します。
高レベルのプロダクト発表や機能リリースについては、リリースノートをご覧ください。
お好みのフィード形式でチェンジログを購読できます：
これらのフィードURLのいずれかをRSSリーダー、ニュースアグリゲーター、または監視ツールに追加すると、新しいチェンジログエントリが公開されたときに自動通知を受け取ることができます。
これらの更新についてご質問がある場合や、統合に関するサポートが必要な場合は、サポートチームまでお気軽にお問い合わせください。
これはチェンジログの最初のエントリです。開発者向けインターフェースと動作が変更される際は、引き続きここに更新を投稿します。