FAIL 상태 Webhook 이벤트에 ageCategory가 포함되도록 업데이트되었습니다
연령 데이터가 사용 가능한 경우 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를 사용하지 마세요. 분석, 로깅 또는 정보 제공 목적으로만 사용하세요.