メインコンテンツに移動

2件の投稿件のタグ「verification-result」を含む

すべてのタグを見る

検証ドキュメントの更新

検証ドキュメントを更新し、メソッドフィールドの説明を改善し、ガイダンスを明確にしました。

新機能

Verification Result ドキュメント

Verification.Result Webhookドキュメントを更新しました:

  • ageCategoryガイダンス: PASSステータスの場合、ageCategoryは常に存在し、生の年齢値ではなくアクセス制御の決定に使用すべきであることを明確化
  • メソッドフィールドの更新:
    • メソッドフィールドリストからself-confirmationemail-confirmationを削除
    • age-estimation-scanの説明を更新し、年齢範囲を返す顔年齢推定スキャン(DOBなし)であることを示すようにしました

更新されたドキュメント

FAILステータスのWebhookイベントにageCategoryが含まれるようになりました

年齢データが利用可能な場合、Verification.Result WebhookイベントのFAILステータスイベントにageCategoryフィールドが含まれるように更新しました。

新機能

FAILステータスイベントでのageCategory

ageCategoryフィールドは、次の条件を満たす場合、Verification.Result WebhookイベントのFAILステータスに含まれるようになりました:

  • failureReasonage-criteria-not-met
  • 年齢データが利用可能(age.lowage.highの両方が存在)

これにより、年齢基準を満たさないために検証が失敗した場合でも、ユーザーの年齢カテゴリに関するより完全な情報が提供され、明確なアクセス制御の境界を維持しながら、より優れた分析とログ記録が可能になります。

ドキュメントの更新

Verification.Resultドキュメントがこの変更を反映するように更新されました:

  • フィールドテーブル: FAILステータスでageCategoryが存在するタイミングを明確にするために説明を更新
  • 主な違いテーブル: WebhookイベントとAPIエンドポイントでageCategoryが存在するタイミングを明確化
  • FAILステータスのフィールド存在ルール: 特定の条件でageCategoryを「場合によって含まれる」として表示するように更新
  • 完全なフィールドマトリックス: WebhookのFAILステータスでageCategoryを「sometimes²」として表示するように更新
  • ペイロードの例: 新しい動作を示すためにFAILステータスの例にageCategoryを追加
  • 実装チェックリスト: FAILステータスでageCategoryを処理するためのガイダンスを更新
  • 実装ノート: PASSとFAILの両方のステータスでのageCategoryの動作を明確化

重要な注意事項

  • アクセス制御: FAILステータスイベントでageCategoryが存在する場合でも、アクセス制御の決定に決して使用しないでください。アクセスを決定するには、常にstatusフィールドを使用してください。
  • 一貫性: この更新はWebhookイベントとAPIエンドポイントの応答の両方に適用されます
  • 言語サポート: すべての言語バージョン(英語、日本語、簡体字中国語、韓国語)が更新されました

次のステップ

  • 更新されたVerification.Resultドキュメントを確認してください
  • 必要に応じて、FAILステータスイベントでageCategoryを処理するように統合を更新してください
  • 覚えておいてください: ステータスがFAILの場合、フィールドが存在する場合でも、アクセス制御にageCategoryを使用しないでください。分析、ログ記録、または情報提供の目的でのみ使用してください。