Didit API 및 웹훅을 위한 비동기 Python 성능 최적화 (KO)

API 상호작용 최적화Python의 asyncio를 활용하여 Didit API에 대한 논블로킹 호출을 수행함으로써, 신원 확인 처리량을 획기적으로 개선하고 대량 작업의 지연 시간을 줄일 수 있습니다.

효율적인 웹훅 처리비동기 웹훅 핸들러를 구현하여 들어오는 Didit 이벤트를 차단 없이 처리함으로써, 애플리케이션이 항상 반응성을 유지하고 수많은 동시 알림을 처리할 수 있도록 확장할 수 있습니다.

속도 제한 관리 마스터하기비동기 기술과 지능적인 백오프 전략을 사용하여 Didit API의 속도 제한을 이해하고 효과적으로 관리함으로써 서비스 중단을 방지하고 안정적인 데이터 교환을 보장합니다.

Didit의 AI-네이티브 이점Didit 플랫폼은 고성능과 개발자 친화성을 위해 설계되었으며, 프로그래밍 방식 등록 및 강력한 API를 제공하여 확장 가능하고 AI 기반의 신원 솔루션을 위한 비동기 프로그래밍을 완벽하게 보완합니다.

속도의 필요성: 신원 확인에 비동기 프로그래밍이 중요한 이유

오늘날 빠르게 변화하는 디지털 세상에서 애플리케이션은 즉각적인 응답을 요구합니다. 새로운 사용자를 온보딩하든, 거래를 처리하든, 신원을 확인하든, 지연은 고객 손실과 수익 감소로 이어질 수 있습니다. 특히 신원 확인은 문서 확인, 라이브니스 감지 수행 또는 블랙리스트 확인을 위해 여러 API 호출을 포함하는 경우가 많습니다. 프로그램이 다음 요청으로 이동하기 전에 각 요청이 완료될 때까지 기다리는 동기식 API 호출은 특히 대량 데이터를 처리할 때 빠르게 병목 현상이 될 수 있습니다.

이것이 바로 비동기 프로그래밍, 특히 Python의 asyncio가 빛을 발하는 지점입니다. asyncio는 애플리케이션이 주 실행 스레드를 차단하지 않고 여러 작업을 동시에 시작할 수 있도록 하여 훨씬 더 높은 처리량과 응답성을 가능하게 합니다. ID 확인, 수동 및 능동 라이브니스, 1:1 얼굴 매칭 및 AML 스크리닝을 위한 강력한 API를 제공하는 Didit과 같은 강력한 신원 플랫폼과 통합하려면 asyncio를 활용하는 것이 단순한 최적화가 아니라 확장 가능하고 고성능 시스템을 구축하기 위한 필수 요소입니다.

수천 명의 사용자가 동시에 가입을 시도하는 시나리오를 상상해 보세요. 각 가입에는 여러 신원 확인이 필요합니다. 동기식 호출을 사용하면 서버는 이러한 작업을 하나씩 처리하여 긴 대기열과 좌절한 사용자를 초래합니다. asyncio를 사용하면 애플리케이션이 이러한 모든 검사를 거의 동시에 시작하여 결과가 준비되는 대로 다시 가져올 수 있으므로 사용자 경험과 전체 시스템 용량이 크게 향상됩니다.

Didit에 대한 비동기 API 호출 구현

Didit API와 비동기적으로 통합하려면 httpx 또는 aiohttp와 같이 asyncio를 지원하는 HTTP 클라이언트를 사용해야 합니다. 이러한 라이브러리를 사용하면 차단 없이 요청을 보낼 수 있으므로 높은 처리량 시나리오에 이상적입니다.

일반적인 사용 사례인 여러 신원 확인 세션 시작을 고려해 보겠습니다. Didit API는 효율성을 위해 설계되었으며, asyncio를 사용하면 이를 극대화할 수 있습니다. 예를 들어, POST /v3/session/을 통해 확인 세션을 동시에 생성할 수 있습니다. 각 세션에는 Didit의 ID 확인(OCR, MRZ, 바코드) 또는 수동 및 능동 라이브니스 확인이 포함될 수 있습니다.

import asyncio
import httpx

async def create_didit_session(api_key: str, user_id: str):
    url = "https://apx.didit.me/v3/sessions/"
    headers = {"x-api-key": api_key, "Content-Type": "application/json"}
    payload = {"external_id": user_id, "flow_id": "your_flow_id"}
    
    async with httpx.AsyncClient() as client:
        response = await client.post(url, headers=headers, json=payload)
        response.raise_for_status()  # Raise an exception for bad status codes
        return response.json()

async def main():
    didit_api_key = "YOUR_DIDIT_API_KEY"
    user_ids = [f"user_{i}" for i in range(100)] # Simulate 100 users

    tasks = [create_didit_session(didit_api_key, user_id) for user_id in user_ids]
    results = await asyncio.gather(*tasks, return_exceptions=True)

    for i, result in enumerate(results):
        if isinstance(result, Exception):
            print(f"Error creating session for user_{user_ids[i]}: {result}")
        else:
            print(f"Session created for user_{user_ids[i]}: {result['session_id']}")

if __name__ == "__main__":
    asyncio.run(main())

이 예시는 100개의 확인 세션을 동시에 생성하는 방법을 보여줍니다. create_didit_session에 대한 각 호출은 대기 가능한 코루틴입니다. asyncio.gather는 이 모든 것을 병렬로 실행하여 순차 실행에 비해 총 시간을 크게 줄여줍니다.

실시간 업데이트를 위한 Didit 웹훅 비동기 처리

웹훅은 Didit으로부터 실시간 업데이트를 받기 위해 중요하며, ID 확인 완료, AML 스크리닝 결과 또는 주소 증명 확인 결과에 대해 시스템에 알려줍니다. Didit이 웹훅 알림을 보내면 애플리케이션은 후속 웹훅을 차단하지 않고 빠르게 처리해야 합니다. 비동기 웹훅 핸들러는 이를 위해 필수적입니다.

FastAPI 또는 Aiohttp와 같은 일반적인 비동기 Python 웹 프레임워크는 비동기 웹훅 수신기를 구축하는 데 완벽합니다. Didit이 웹훅(예: 세션 완료 알림)을 보내면 핸들러는 페이로드를 구문 분석하고, Didit의 웹훅 구성에서 얻은 secret_shared_key를 사용하여 서명을 확인한 다음, Didit으로 HTTP 응답을 지연시키지 않고 이벤트 처리를 백그라운드 작업 또는 메시지 큐에 대기시킬 수 있습니다.

from fastapi import FastAPI, Request, HTTPException
import hmac
import hashlib
import asyncio

app = FastAPI()
WEBHOOK_SECRET = "whsec_a1b2c3d4e5f6g7h8i9j0..." # Get this from Didit webhook config

async def process_didit_event(event_data: dict):
    # Simulate asynchronous processing, e.g., updating database, notifying users
    print(f"Processing Didit event: {event_data['event_type']} for session {event_data['session_id']}")
    await asyncio.sleep(2) # Simulate I/O bound task
    print(f"Finished processing event for session {event_data['session_id']}")

@app.post("/didit-webhook")
async def didit_webhook(request: Request):
    signature = request.headers.get("X-Didit-Signature")
    if not signature:
        raise HTTPException(status_code=400, detail="Missing X-Didit-Signature header")

    body = await request.body()
    
    # Verify webhook signature (important for security)
    expected_signature = hmac.new(WEBHOOK_SECRET.encode('utf-8'), body, hashlib.sha256).hexdigest()
    if not hmac.compare_digest(signature, expected_signature):
        raise HTTPException(status_code=403, detail="Invalid webhook signature")

    event_data = await request.json()
    
    # Process event asynchronously in the background
    asyncio.create_task(process_didit_event(event_data))
    
    return {"status": "received", "message": "Event accepted for processing"}

이 FastAPI 예시는 웹훅을 빠르게 승인한 다음 asyncio.create_task를 사용하여 실제 처리를 오프로드하는 방법을 보여줍니다. 이는 개별 이벤트 처리에 시간이 걸리더라도 웹훅 엔드포인트가 높은 가용성과 응답성을 유지하도록 보장합니다. Didit의 웹훅 구성은 webhook_url 및 webhook_version을 지정할 수 있도록 하여 안전하고 신뢰할 수 있는 이벤트 전달을 쉽게 설정할 수 있습니다.

비동기 전략으로 속도 제한 탐색

API 속도 제한은 모든 높은 처리량 통합에 대한 중요한 고려 사항입니다. Didit은 모든 견고한 API 공급자와 마찬가지로 안정성을 유지하기 위해 속도 제한을 적용합니다. 이러한 제한을 이해하고 우아하게 처리하는 것은 429 Too Many Requests 오류를 방지하고 지속적인 작업을 보장하는 데 가장 중요합니다.

Didit은 응답에 명확한 속도 제한 헤더(X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, Retry-After)를 제공합니다. asyncio를 사용하면 전체 애플리케이션을 차단하지 않고 지터 및 토큰 버킷 알고리즘을 사용한 지수 백오프와 같은 정교한 속도 제한 전략을 구현할 수 있습니다.

import asyncio
import httpx
import time

async def make_rate_limited_request(client: httpx.AsyncClient, url: str, headers: dict, payload: dict, retries: int = 5):
    for attempt in range(retries):
        response = await client.post(url, headers=headers, json=payload)
        if response.status_code == 429:
            retry_after = int(response.headers.get("Retry-After", 2 ** attempt)) # Exponential backoff
            print(f"Rate limit hit. Retrying in {retry_after} seconds...")
            await asyncio.sleep(retry_after)
        else:
            response.raise_for_status()
            return response.json()
    raise Exception("Max retries exceeded for rate-limited request.")

async def main_rate_limited():
    didit_api_key = "YOUR_DIDIT_API_KEY"
    url = "https://apx.didit.me/v3/sessions/"
    headers = {"x-api-key": didit_api_key, "Content-Type": "application/json"}
    
    async with httpx.AsyncClient() as client:
        tasks = []
        for i in range(150): # Simulate exceeding a 300 rpm limit with 150 tasks
            payload = {"external_id": f"user_{i}", "flow_id": "your_flow_id"}
            tasks.append(make_rate_limited_request(client, url, headers, payload))
        
        results = await asyncio.gather(*tasks, return_exceptions=True)
        for i, result in enumerate(results):
            if isinstance(result, Exception):
                print(f"Request {i} failed: {result}")
            else:
                print(f"Request {i} succeeded: {result.get('session_id')}")

if __name__ == "__main__":
    asyncio.run(main_rate_limited())

이 예시는 비동기 지수 백오프 전략을 보여줍니다. 429가 수신되면 코루틴은 지정된 Retry-After 기간(또는 기하급수적으로 증가하는 시간) 동안 기다린 다음 다시 시도하며, 다른 동시 작업을 차단하지 않습니다. Didit의 전역 제한(GET/Write/Delete 엔드포인트에 대해 애플리케이션당 분당 300개 요청) 및 엔드포인트별 제한(예: POST /v2/session/에 대해 600rpm)은 명확하게 문서화되어 있어 이에 따라 비동기 클라이언트를 설계할 수 있습니다.

Didit이 높은 처리량의 신원 솔루션 구축에 어떻게 도움이 되는가

Didit의 아키텍처는 본질적으로 높은 처리량 작업을 지원하도록 설계되어 비동기 통합을 위한 이상적인 파트너입니다. 우리 플랫폼은 다음과 같은 몇 가지 주요 이점을 제공합니다.

• 개발자 우선 및 AI-네이티브: Didit은 깔끔한 API와 포괄적인 문서를 제공하여 Python의 asyncio와 쉽게 통합할 수 있도록 합니다. AI-네이티브 접근 방식은 ID 확인부터 수동 및 능동 라이브니스에 이르는 복잡한 신원 확인 작업을 효율적으로 처리하여 애플리케이션이 단순히 결과를 기다릴 수 있도록 합니다.
• 모듈형 신원 기본 요소: Didit의 모듈형 설계를 통해 필요한 정확한 신원 확인을 선택하고 고를 수 있습니다. ID 확인(OCR, MRZ), 1:1 얼굴 매칭 또는 주소 증명 여부에 관계없이 각 기본 요소는 고성능 API를 통해 액세스할 수 있으며, 동시 호출에 완벽하게 적합합니다.
• 프로그래밍 방식 등록: 많은 플랫폼과 달리 Didit은 AI 에이전트까지 프로그래밍 방식 등록을 허용합니다. 브라우저를 열 필요 없이 두 번의 API 호출만으로 완전히 헤드리스 방식으로 API 자격 증명을 얻을 수 있습니다. 이는 설정 마찰을 최소화하고 신원 인프라의 자동화된 대규모 배포를 가능하게 합니다.
• 오케스트레이션된 워크플로우: Didit의 노코드 엔진을 사용하면 복잡한 KYC 워크플로우를 오케스트레이션하여 애플리케이션이 관리해야 하는 개별 API 호출 수를 줄이면서 전체 세션 결과의 비동기 처리를 통해 이점을 얻을 수 있습니다.
• 무료 핵심 KYC 및 유연한 가격 책정: Didit은 무료 핵심 KYC를 제공하여 선불 비용 없이 시작할 수 있도록 합니다. 성공적인 확인당 지불 모델과 설정 비용 없음은 사용한 만큼만 지불한다는 것을 의미하며, 비동기 처리를 통해 가능해진 확장 가능하고 사용량 기반 아키텍처와 완벽하게 일치합니다.

Python asyncio의 강력한 기능과 Didit의 견고하고 개발자 친화적인 API를 결합하여 안전하고 규정을 준수할 뿐만 아니라 현대 디지털 비즈니스의 요구 사항을 처리할 수 있는 놀랍도록 빠르고 확장 가능한 신원 확인 시스템을 구축할 수 있습니다.

시작할 준비가 되셨습니까?

Didit의 실제 작동을 보고 싶으십니까? 지금 무료 데모를 받아보세요.

Didit의 무료 등급으로 무료로 신원 확인을 시작하세요.