Didit 통합 디버깅: 일반적인 문제점 및 해결 전략 (KO)

API 키 및 인증 문제인증 실패는 모든 API 통합에서 흔히 발생하는 초기 장애물이므로, API 키가 올바르게 구성되고 환경 변수가 제대로 설정되었는지 확인하세요.

속도 제한 및 스로틀링지수 백오프를 사용하여 견고한 속도 제한 처리를 구현하고 X-RateLimit 헤더를 모니터링하여 서비스 중단을 방지하고 애플리케이션 안정성을 보장하세요.

세션 수명 주기 관리사용자 확인 진행 상황을 정확하게 추적하려면 생성부터 상태 업데이트, 결정 검색에 이르기까지 Didit 확인 세션의 전체 수명 주기를 이해해야 합니다.

Didit의 개발자 우선 접근 방식Didit은 포괄적인 문서, 즉각적인 샌드박스 및 깨끗한 API를 제공하여 디버깅 프로세스를 크게 간소화하고 개발자를 위한 통합 복잡성을 줄여줍니다.

애플리케이션에 신원 확인을 통합하는 것은 보안 및 규정 준수를 위한 중요한 단계입니다. 그러나 모든 복잡한 시스템과 마찬가지로 Didit과 같은 신원 플랫폼과의 통합은 고유한 디버깅 문제를 야기할 수 있습니다. 이 가이드는 개발자가 일반적인 문제점을 식별하고 해결하여 Didit의 강력한 신원 확인 서비스와 원활하고 효율적인 통합 프로세스를 보장하는 데 도움이 되도록 설계되었습니다.

API 인증 및 구성 이해

통합 문제의 가장 빈번한 시작점 중 하나는 API 인증 및 구성에 있습니다. 잘못 구성된 API 키, 잘못된 환경 변수 또는 네트워크 액세스 제한은 모두 좌절스러운 인증 오류로 이어질 수 있습니다.

일반적인 문제점:

• 잘못된 API 키: 요청에 사용된 API 키가 Didit 비즈니스 콘솔에서 제공된 키와 일치하는지 확인하세요. API 키는 대소문자를 구분합니다.
• 환경 변수 문제: API 키를 환경 변수(예: DIDIT_API_KEY)에 저장하는 경우, 런타임에 애플리케이션에서 올바르게 로드되고 액세스 가능한지 다시 확인하세요.
• 권한: API 키에 수행하려는 작업에 필요한 권한이 있는지 확인하세요. 일부 작업에는 특정 범위가 필요할 수 있습니다.
• 네트워크 제한: 방화벽 또는 프록시 서버가 때때로 아웃바운드 API 호출을 차단할 수 있습니다. 서버가 Didit의 API 엔드포인트에 제한 없이 액세스할 수 있는지 확인하세요.

문제 해결 전략:

• 자격 증명 다시 확인: 가장 간단한 해결책이 가장 효과적일 때가 많습니다. 오타를 피하기 위해 Didit 비즈니스 콘솔에서 API 키를 직접 복사하여 붙여넣으세요.
• cURL 또는 Postman과 같은 도구 사용: 코드베이스에 통합하기 전에 직접 cURL 명령 또는 Postman 요청으로 API 키를 테스트하여 애플리케이션 수준 버그와 인증 문제를 분리하세요.
• 오류 메시지 검사: Didit의 API는 명확한 오류 메시지를 제공합니다. 401 Unauthorized 또는 403 Forbidden 응답은 일반적으로 인증 또는 권한 문제를 나타냅니다.
• Didit 문서 참조: Didit API 참조는 인증 방법 및 예상 헤더에 대한 자세한 정보를 제공합니다.

속도 제한 및 API 스로틀링 처리

안정성과 공정한 사용을 유지하기 위해 Didit은 대부분의 강력한 API 제공업체와 마찬가지로 속도 제한을 구현합니다. 이러한 제한을 고려하지 않으면 일시적인 서비스 중단 및 429 Too Many Requests 오류가 발생할 수 있습니다.

일반적인 문제점:

• 요청 급증: 특히 세션 생성 또는 결정 검색과 같은 리소스 집약적인 작업의 경우, 짧은 시간 내에 많은 요청을 보내면 빠르게 제한에 도달할 수 있습니다. 예를 들어, POST /v2/session/은 분당 600개의 요청 제한이 있으며, GET /v2/session/<id>/decision/은 과도한 폴링을 방지하기 위해 분당 100개의 요청으로 제한됩니다.
• 속도 제한 헤더 무시: X-RateLimit-Limit, X-RateLimit-Remaining 및 X-RateLimit-Reset 헤더를 모니터링하지 않으면 예기치 않은 스로틀링이 발생할 수 있습니다.
• 지수 백오프 부족: 지수 백오프 전략 없이는 429 오류 후 즉시 재시도하면 계속해서 실패할 가능성이 높습니다.

문제 해결 전략:

• 헤더 모니터링: Didit의 API 응답에서 제공되는 속도 제한 헤더를 항상 구문 분석하고 응답하세요. 이를 통해 애플리케이션이 사전에 자체적으로 조절할 수 있습니다.
• 지수 백오프 구현: 429 응답을 받으면 요청을 재시도하기 전에 대기 시간을 점진적으로 늘리세요. 일반적인 패턴은 5초 → 10초 → 20초 → 40초입니다.
• 일괄 작업: 가능한 경우 특정 작업을 일괄 처리하거나 API 호출 빈도를 줄이도록 워크플로를 설계하세요.
• 분산 속도 제한: 여러 애플리케이션 인스턴스가 있는 경우, 개별 인스턴스에서 전역 제한을 초과하지 않도록 중앙 집중식 속도 제한 메커니즘을 고려하세요.

확인 세션 수명 주기 관리

Didit의 신원 확인 프로세스는 세션을 중심으로 진행됩니다. 이러한 세션을 생성, 관리하고 결과를 검색하는 방법을 이해하는 것이 중요합니다. 세션 상태를 오해하거나 비동기 확인 흐름을 부적절하게 처리하면 문제가 발생하는 경우가 많습니다.

일반적인 문제점:

• 잘못된 세션 생성: didit_create_session을 호출할 때 필요한 모든 매개변수를 제공하지 않거나 유효하지 않은 워크플로 ID를 사용하면 세션이 올바르게 시작되지 않을 수 있습니다.
• 너무 자주 폴링: 적절한 지연 없이 didit_get_session_decision을 반복적으로 호출하면 속도 제한에 도달하고 리소스가 낭비될 수 있습니다.
• 모든 세션 결과 처리 실패: 세션은 다양한 상태(예: pending, approved, declined, resubmission_requested)를 가질 수 있으며, 애플리케이션은 각 상태를 처리할 준비가 되어 있어야 합니다.
• 웹훅 오설정: 세션 업데이트를 위해 웹훅 대신 폴링에만 의존하면 지연 및 복잡성이 발생할 수 있습니다. 웹훅을 사용하는 경우, 올바르게 구성되었는지, 엔드포인트에 연결할 수 있고 응답하는지 확인하세요.

문제 해결 전략:

• 워크플로 구성 검토: didit_get_workflow를 사용하여 확인 워크플로의 구성을 검사하여 예상되는 확인 단계(예: ID 확인, 수동 및 능동 라이브니스, 1:1 얼굴 일치)와 일치하는지 확인하세요.
• Didit의 웹훅 활용: 웹훅을 구성하여 세션 상태 변경에 대한 실시간 업데이트를 받으세요. 이는 비동기 확인 결과를 관리하는 가장 효율적인 방법입니다. 수신 요청의 진위 여부를 확인하기 위해 웹훅 서명을 검증하세요.
• 세션 ID 기록: 세션이 생성될 때 항상 Didit session_id를 기록하세요. 이 ID는 디버깅 및 didit_get_session_decision과 같은 도구를 사용하여 나중에 자세한 정보를 검색하는 데 중요합니다.
• 에지 케이스 테스트: 성공적인 확인, 거부 및 재제출이 필요한 경우를 포함한 다양한 결과를 시뮬레이션하여 애플리케이션이 모든 가능성을 원활하게 처리하는지 확인하세요.

Didit이 도움이 되는 방법

Didit은 개발자를 염두에 두고 설계되었으며, 통합 및 디버깅을 크게 단순화하는 다양한 기능을 제공합니다. 당사의 AI 기반 모듈식 신원 플랫폼은 일반적인 통합 문제를 방지하고 해결하기 위한 강력한 도구를 제공합니다.

• 개발자 우선 설계: Didit은 즉각적인 샌드박스, 포괄적인 공개 문서 및 깨끗한 API를 제공하여 쉽게 시작하고 문제를 해결할 수 있도록 합니다. API 우선 접근 방식은 신원 확인의 모든 측면을 프로그래밍 방식으로 관리할 수 있음을 의미합니다.
• 모듈식 아키텍처: ID 확인(OCR, MRZ, 바코드), 수동 및 능동 라이브니스, 1:1 얼굴 일치 및 AML 심사를 포함한 당사의 구성 가능한 신원 기본 요소를 통해 확인 흐름을 점진적으로 구축하고 테스트하여 잠재적인 문제를 특정 모듈로 격리할 수 있습니다.
• 오케스트레이션된 워크플로: 코드 없는 비즈니스 콘솔을 통해 복잡한 KYC 워크플로를 시각적으로 구성하고 테스트하여 통합의 논리적 오류 가능성을 줄일 수 있습니다.
• AI 에이전트 통합(MCP 서버): Didit은 에이전트 시대를 위해 구축되었습니다. 당사의 MCP(Model Context Protocol) 서버를 통해 AI 코딩 에이전트가 플랫폼과 직접 상호 작용하여 계정 등록, 워크플로 구성 및 세션 관리와 같은 작업을 자동화하여 수동 오류를 더욱 줄이고 디버깅 속도를 높입니다.
• 무료 핵심 KYC: 선불 비용 없이 신원 확인을 시작하여 재정적 장벽 없이 실제와 같은 환경에서 광범위한 테스트 및 디버깅을 할 수 있습니다. 설정 비용 없이 성공적인 확인당 지불 모델을 통해 사용한 만큼만 지불합니다.
• 자세한 오류 보고: Didit의 API는 명확하고 실행 가능한 오류 메시지를 제공하여 문제의 근본 원인을 직접 안내합니다.

시작할 준비가 되셨나요?

Didit의 작동 방식을 보고 싶으신가요? 지금 무료 데모를 받아보세요.

Didit의 무료 티어로 무료로 신원 확인을 시작하세요.