개발자 가이드: CDN 엣지 캐싱을 위한 Didit API 호출 최적화 (KO)

속도 제한 이해Didit은 API 안정성을 유지하기 위해 전역 및 엔드포인트별 속도 제한을 적용하며, 클라이언트 측 스로틀링을 위해 X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset 헤더를 제공합니다.

지수 백오프 구현429 응답의 경우, 일시적인 API 과부하를 정상적으로 처리하고 클라이언트 측 속도 제한 위반을 방지하기 위해 지수 백오프 전략(예: 5초 → 10초 → 20초)을 통합하세요.

정적 자산에 CDN 활용Didit의 핵심 API는 기존 CDN으로 캐시할 수 없지만, CDN을 통해 애플리케이션의 정적 자산(JS, CSS, 이미지)을 최적화하여 로드 시간을 줄이고 인지되는 성능을 향상시키세요.

Didit의 성능 아키텍처Didit의 AI 기반 글로벌 분산 인프라는 본질적으로 낮은 지연 시간과 높은 가용성을 제공하여, 성능이 중요한 신원 확인 요구사항에 이상적인 선택입니다.

오늘날 빠르게 변화하는 디지털 환경에서는 모든 밀리초가 중요합니다. 신원 확인 서비스를 통합하는 개발자에게는 속도와 효율성을 위해 API 호출을 최적화하는 것이 가장 중요합니다. 콘텐츠 전송 네트워크(CDN)는 종종 정적 자산 캐싱과 관련이 있지만, 신원 확인과 같이 동적이고 실시간 운영을 위해 설계된 API 서비스와 상호 작용하는 최선의 방법을 이해하는 것은 전반적인 애플리케이션 성능에 매우 중요합니다. 이 가이드는 속도 제한, 효율적인 호출 패턴, 그리고 Didit의 아키텍처가 어떻게 본질적으로 고성능을 지원하는지에 초점을 맞춰 Didit API 통합을 최적화하는 방법을 자세히 설명합니다.

Didit의 API 속도 제한 이해

Didit은 모든 클라이언트에서 안정성과 공정한 사용을 보장하기 위해 다른 강력한 API 서비스와 마찬가지로 속도 제한을 구현합니다. 이러한 제한은 남용을 방지하고 일관된 성능을 유지하는 데 중요합니다. 이를 이해하고 준수하는 것이 API 상호 작용 최적화를 위한 첫 번째 단계입니다.

Didit은 여러 계층의 속도 제한을 적용합니다:

• 글로벌 제한: 일반 GET 엔드포인트의 경우, 애플리케이션당 분당 300개의 요청으로 제한됩니다. 마찬가지로 POST, PATCH, DELETE (쓰기/삭제) 엔드포인트도 애플리케이션당 분당 300개의 요청으로 글로벌 상한이 있습니다.
• 엔드포인트별 제한: 특정 고영향 작업에는 더 엄격한 제한이 있습니다. 예를 들어, POST /v2/session/ (Didit의 ID 확인 또는 연령 추정 제품을 포함하는 확인 세션 생성용)은 분당 600개의 요청으로 제한됩니다. 세션 결정 검색 (`GET /v2/session//decision/)은 과도한 폴링을 방지하기 위해 분당 100개의 요청으로 스로틀링되며, PDF 생성 (GET /session//generate-pdf/`)은 CPU 집약적인 특성으로 인해 분당 100개로 제한됩니다.

속도 제한을 초과하면 Didit의 API는 429 Too Many Requests 상태 코드로 응답합니다. 중요하게도, 이러한 응답에는 유용한 헤더가 포함됩니다:

• X-RateLimit-Limit: 허용되는 최대 요청 수입니다.
• X-RateLimit-Remaining: 현재 창에 남아있는 요청 수입니다.
• X-RateLimit-Reset: 현재 속도 제한 창이 재설정되는 시간(에포크 초)입니다.

이러한 헤더를 모니터링함으로써 애플리케이션은 사전에 자체적으로 스로틀링하여 불필요한 429 오류를 방지하고 Didit의 AML 심사 또는 생체 감지 서비스와 같은 서비스에 대해 더 원활한 운영 흐름을 보장할 수 있습니다.

스마트 클라이언트 측 스로틀링 및 백오프 구현

속도 제한을 효과적으로 클라이언트 측에서 처리하는 것은 탄력적인 통합에 매우 중요합니다. 방법은 다음과 같습니다:

1. 속도 제한 헤더 주시: X-RateLimit-Remaining 헤더를 읽는 로직을 구현합니다. 이 값이 특정 임계값(예: X-RateLimit-Limit의 15%) 아래로 떨어지면 클라이언트는 요청 속도를 늦추기 시작해야 합니다.

2. 429에 대한 지수 백오프: 이것은 중요한 전략입니다. 애플리케이션이 429 응답을 받으면 요청을 재시도하기 전에 잠시 멈춰야 합니다. 즉시 재시도하는 대신, 지수 백오프 알고리즘을 구현합니다. 예를 들어, 5초, 10초, 20초 등 기다립니다. 이렇게 하면 API에 더 많은 과부하를 주는 것을 방지하고 속도 제한 창이 재설정될 수 있도록 합니다. Didit의 Retry-After 헤더도 백오프 전략에 정보를 제공할 수 있습니다.

3. 로그 및 경고: 속도 제한이 발생한 시점과 재시도가 트리거된 시점을 추적합니다. 이는 애플리케이션의 사용 패턴에 대한 귀중한 통찰력을 제공하며 최적화 영역을 식별하거나 특정 사용 사례에 대해 Didit 지원팀에 더 높은 제한을 요청해야 할 필요성을 나타내는 데 도움이 될 수 있습니다.

API 성능에서 CDN 엣지 캐싱의 역할

ID 확인, 1:1 얼굴 매칭 또는 NFC 확인과 같은 Didit의 핵심 신원 확인 API는 동적이고 실시간 처리를 포함하므로 CDN으로 효과적으로 캐시할 수 없습니다(각 요청이 고유하고 새로운 계산이 필요하기 때문입니다). 하지만 CDN은 여전히 애플리케이션의 전반적인 성능에 중요한 역할을 합니다.

CDN은 사용자에게 더 가까운 엣지 위치에서 정적 콘텐츠(이미지, JavaScript, CSS 파일, 비디오)를 캐싱하는 데 탁월합니다. 이러한 자산을 CDN에서 제공함으로써 원본 서버의 부하를 줄이고 사용자의 지연 시간을 줄일 수 있습니다. 이는 애플리케이션의 인지되는 성능을 향상시켜 신원 확인 흐름을 포함한 전반적인 경험을 훨씬 빠르고 반응적으로 느끼게 합니다.

예를 들어, 애플리케이션이 웹 기반 사용자 인터페이스(예: 문서 업로드 또는 생체 감지 셀피 수집용)를 포함하는 Didit 워크플로를 사용하는 경우, 해당 UI의 정적 자산은 CDN을 통해 제공될 수 있습니다. 검증 처리를 위한 Didit 백엔드로의 API 호출은 직접적이지만, 주변 애플리케이션 환경의 속도는 사용자 만족도에 크게 영향을 미칩니다.

타의 추종을 불허하는 성능을 위한 Didit의 AI 기반 아키텍처

Didit은 AI 기반의 개발자 우선 신원 플랫폼으로 처음부터 구축되었습니다. 이러한 아키텍처 선택은 정적 자산에 대한 CDN 전략을 보완하는 중요한 성능 이점을 본질적으로 제공합니다:

• 글로벌 분산: Didit의 인프라는 전 세계적으로 분산되어 있어 사용자의 지리적 위치에 관계없이 낮은 지연 시간을 보장합니다. 이는 Didit의 확인 엔드포인트로의 API 호출이 가장 가까운 데이터 센터로 라우팅되어 네트워크 이동 시간을 최소화한다는 것을 의미합니다.
• 실시간에 최적화: 수동 및 능동 생체 감지 및 1:1 얼굴 매칭과 같은 제품은 실시간 처리를 위해 설계되었으며, 빠르고 효율적으로 실행되는 고급 AI 모델을 활용합니다.
• 확장성: Didit의 모듈식 아키텍처는 확장성을 위해 구축되었으며, 피크 기간에도 성능 저하 없이 대량의 확인 요청을 처리할 수 있습니다. 이는 전화 및 이메일 확인 또는 주소 증명과 같은 서비스에 대해 높은 처리량을 요구하는 애플리케이션에 매우 중요합니다.
• 개발자 우선 API: 깨끗하고 잘 문서화된 API는 개발자가 효율적으로 통합할 수 있도록 보장하여 개발 시간과 통합 관련 성능 병목 현상 가능성을 줄입니다. 단 두 번의 API 호출만으로 등록할 수 있는 프로그래밍 방식의 등록 프로세스는 이러한 개발자 우선 접근 방식을 잘 보여줍니다.

스마트 속도 제한 처리 및 지수 백오프와 같은 효율적인 API 소비 관행에 집중함으로써 Didit의 고성능 AI 기반 백엔드를 최대한 활용하여 원활하고 빠른 신원 확인 경험을 제공할 수 있습니다.

Didit의 도움

Didit은 고성능의 안정적인 신원 확인 경험을 제공하도록 설계되었습니다. 당사의 AI 기반 플랫폼은 모듈식 아키텍처를 제공하여 ID 확인(OCR, MRZ 및 바코드 지원), 수동 및 능동 생체 감지, 1:1 얼굴 매칭, AML 심사 및 모니터링과 같은 특정 신원 기본 요소를 필요에 따라 통합할 수 있습니다. 이러한 모듈성은 필요한 리소스만 사용하므로 비용과 성능을 모두 최적화합니다. Didit의 무료 핵심 KYC는 설정 비용이 없고 성공적인 확인 건당 지불하는 모델로, 시작하기가 매우 쉽습니다. 당사의 글로벌 분산 인프라는 API 호출이 낮은 지연 시간과 높은 가용성으로부터 이점을 얻도록 보장하여, 신원 확인의 동적 특성이 실시간 처리를 요구하므로 API 응답의 기존 CDN 캐싱의 필요성을 줄여줍니다. 우리는 개발자에게 속도와 효율성을 본질적으로 우선시하는 강력하고 확장 가능한 솔루션을 제공하여, 신원 신뢰의 복잡성을 처리하는 동안 훌륭한 애플리케이션을 구축하는 데 집중할 수 있도록 지원합니다.

시작할 준비가 되셨나요?

Didit이 작동하는 것을 볼 준비가 되셨나요? 지금 무료 데모를 받아보세요.

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