2개의 게시물개의 게시물이 "verification-result" 태그를 포함

확인 문서를 업데이트하여 메서드 필드 설명을 개선하고 가이드를 명확히 했습니다.

새로운 기능​

Verification Result 문서​

Verification.Result Webhook 문서를 업데이트했습니다:

• ageCategory 가이드: PASS 상태의 경우 ageCategory가 항상 존재하며 원시 연령 값보다는 액세스 제어 결정에 사용해야 함을 명확히 했습니다
• 메서드 필드 업데이트:
  • 메서드 필드 목록에서 self-confirmation 및 email-confirmation 제거
  • age-estimation-scan 설명을 업데이트하여 연령 범위를 반환하는 얼굴 연령 추정 스캔(DOB 없음)임을 나타내도록 했습니다

업데이트된 문서​

• Verification.Result Webhook

연령 데이터가 사용 가능한 경우 Verification.Result Webhook 이벤트의 FAIL 상태 이벤트에 ageCategory 필드가 포함되도록 업데이트했습니다.

새로운 기능​

FAIL 상태 이벤트의 ageCategory​

ageCategory 필드는 다음 조건을 만족할 때 Verification.Result Webhook 이벤트의 FAIL 상태에 포함되도록 업데이트되었습니다:

• failureReason이 age-criteria-not-met
• 연령 데이터가 사용 가능함 (age.low와 age.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를 사용하지 마세요. 분석, 로깅 또는 정보 제공 목적으로만 사용하세요.