본문으로 건너뛰기

엣지 케이스 처리 예제

연령 확인 가이드에 포괄적인 엣지 케이스 처리 예제를 추가하고 필드 존재 규칙을 명확히 하기 위해 확인 이벤트 계약을 업데이트했습니다.

새로운 기능​

엣지 케이스 처리 예제​

워터폴 플로우 가이드에 확인 엣지 케이스를 처리하기 위한 상세한 코드 예제가 포함되었습니다. 각 예제는 잘못된 처리 패턴과 올바른 처리 패턴을 모두 보여줍니다.

새로운 예제에는 다음이 포함됩니다:​

  • 부분적 시도 (최대 시도 횟수 초과): 사용자가 확정적인 연령 결정 없이 모든 확인 시도를 소진한 경우 max-attempts-exceeded 실패 이유의 적절한 처리
  • 의심스러운 활동 감지: 적절한 속도 제한 및 보안 조치를 포함한 fraudulent-activity-detected 실패 이유의 보안 중심 처리
  • 완전한 엣지 케이스 핸들러: 모든 패턴을 함께 보여주는 포괄적인 TypeScript 예제

모든 예제는 완전한 필드 존재 규칙에 대해 확인 이벤트 계약에 직접 연결됩니다.

확인 이벤트 계약 업데이트​

확인 이벤트 계약이 필드 존재 규칙을 명확히 하기 위해 업데이트되었습니다:

  • age 및 ageCategory는 PASS 상태일 때 항상 존재: PASS를 초래하는 모든 확인 방법은 연령 정보와 연령 카테고리를 모두 제공합니다. PASS 상태 결과를 처리할 때 조건부 검사 없이 이러한 필드에 안전하게 액세스할 수 있습니다.
  • 연령 범위 명확화: 확인 방법에서 정확한 연령이 제공되지 않을 때 age.low는 확인에 필요한 임계값 최소 연령이 되고 age.high는 100이 됩니다.

업데이트된 문서​

모바일 앱 통합 가이드 및 ConnectID 테스트 업데이트

k-ID 위젯을 모바일 애플리케이션에 통합하는 데 도움이 되는 포괄적인 모바일 앱 통합 문서를 추가하고 ConnectID 테스트 리소스를 강화했습니다.

새로운 기능​

모바일 앱 통합 가이드​

새로운모바일 앱 빠른 시작 가이드는 k-ID 위젯을 모바일 애플리케이션에 통합하기 위한 포괄적인 문서를 제공합니다. 이 가이드는 다음을 다룹니다:

  • 플랫폼별 구현 방법: Android(Custom Tabs, WebView, Trusted Web Activity) 및 iOS(ASWebAuthenticationSession, SFSafariViewController, WKWebView)에 대한 상세한 가이드
  • AgeKeys 지원: 어떤 구현 방법이 AgeKeys 및 WebAuthn을 지원하는지에 대한 명확한 문서
  • 결과 통신: 위젯 결과를 수신하는 두 가지 접근 방식—콜백 URL(권장) 및 DOM 메시지
  • 타사 앱 확인 흐름: ConnectID와 같은 확인 방법이 타사 앱을 통해 리디렉션하는 방법에 대한 완전한 문서
  • 완전한 코드 예제: iOS(Swift) 및 Android(Kotlin) 모두에 대한 단계별 구현 예제 및 전체 코드 샘플

ConnectID 테스트 강화​

모바일 앱 테스트 리소스를 사용한 ConnectID 테스트 문서 강화:

  • 모바일 앱 테스트 앱: 모바일 애플리케이션에서 완전한 리디렉션 흐름을 검증하기 위해 iOS(TestFlight) 및 Android(Google Play)용 ConnectID Mock Bank C 테스트 앱 링크 추가
  • 테스트 섹션 업데이트: 모바일 앱 리디렉션 흐름 테스트를 위한 전용 하위 섹션으로 ConnectID 테스트 섹션 확장

업데이트된 문서​

변경 로그 소개

새로운 변경 로그 섹션을 소개합니다! 이는 개발자 인터페이스, API 동작 및 통합 패턴의 변경 사항을 알려주는 중앙 집중식 장소로 사용됩니다.

새로운 기능​

변경 로그 섹션​

오늘부터 개발자 관련 변경 사항에 대한 업데이트를 한 곳에서 확인할 수 있습니다. 다음에 대해 정기적으로 업데이트를 게시하여 정보를 제공합니다:

  • API 업데이트 및 변경: 새로운 엔드포인트, 매개변수 수정 및 사용 중단
  • 이벤트 시스템 업데이트: DOM 이벤트 및 Webhook 변경
  • 인터페이스 및 동작 변경: 개발자 인터페이스 및 통합 패턴 업데이트
  • 주요 변경 사항: 통합에 영향을 줄 수 있는 중요한 업데이트

검증 이벤트 계약​

모든 검증 결과 데이터의 예상 형식에 대한 신뢰할 수 있는 참조 자료를 개발자에게 제공하기 위해 검증 이벤트 계약을 도입합니다. 이 계약은 DOM 이벤트와 Webhook 모두에 적용되며, 통합을 위한 안정적인 참조로 유지하겠다는 약속을 합니다.

이것이 의미하는 바:​

  • 일관된 이벤트 구조: 모든 이벤트 유형에서 예측 가능한 이벤트 페이로드
  • 포괄적인 문서: 통합을 용이하게 하는 완전한 이벤트 스키마 및 예제
  • 신뢰할 수 있는 참조: 검증 결과 데이터 형식에 대한 안정적인 참조 자료로 이 계약을 유지하겠다는 약속을 합니다

이벤트 구조 및 통합에서 사용 방법에 대한 자세한 내용은 이벤트 문서를 참조하세요.

최신 정보 유지​

이 변경 로그를 북마크하고 정기적으로 확인하거나 업데이트를 구독하여 k-ID 플랫폼의 최신 변경 사항을 계속 확인하세요. 통합에 영향을 줄 수 있는 모든 업데이트에 대해 알려드리겠습니다.

고급 프로덕트 발표 및 기능 출시는 릴리스 노트를 참조하세요.

업데이트 구독​

선호하는 피드 형식으로 변경 로그를 구독할 수 있습니다:

이러한 피드 URL 중 하나를 RSS 리더, 뉴스 애그리게이터 또는 모니터링 도구에 추가하면 새로운 변경 로그 항목이 게시될 때 자동 알림을 받을 수 있습니다.

이러한 업데이트에 대한 질문이 있거나 통합에 대한 지원이 필요한 경우 지원 팀에 문의하세요.

이것은 변경 로그의 첫 번째 항목입니다. 개발자 인터페이스와 동작이 변경될 때 여기에 계속 업데이트를 게시하겠습니다.