메인 콘텐츠로 건너뛰기
Python용 공식 Didit 라이브러리입니다. Python 3.10 이상이 필요하며, 동기 클라이언트 Didit와 비동기 클라이언트 AsyncDidit를 제공합니다. 두 클라이언트는 같은 메서드를 가집니다. 모든 SDK가 공유하는 내용은 서버 SDK 개요를 참조하십시오.

설치

패키지는 PyPI의 didit-sdk입니다. 소스 코드와 변경 로그는 GitHub의 didit-protocol/sdk-python에 있습니다. Authentication 토큰을 검증하려면 서명 검사를 추가하는 추가 옵션을 함께 설치하십시오:

클라이언트 구성

Didit()는 환경 변수에서 DIDIT_API_KEY를 읽습니다. 이를 재정의하거나, 애플리케이션 범위 호출(케이스, 네트워크, 규제 보고서)에 필요한 조직 ID와 애플리케이션 ID를 설정하려면 옵션을 전달하십시오.

세션 생성

워크플로에 대한 인증 세션을 생성하고, 사용자를 해당 URL로 보내십시오.

결정 읽기

사용자가 완료하면(또는 webhook이 도착하면) 결정을 읽으십시오. 모든 기능 결과는 워크플로 노드마다 항목 하나씩을 담은 목록입니다.

webhook 검증

정확한 원시 본문 바이트와 요청 헤더를 전달하십시오. verify는 유효하지 않거나 유효 기간이 지난 전송에 대해 WebhookVerificationError를 발생시키므로, 이 클래스 하나만 잡으면 충분합니다.
Flask에서는 handle_webhook(request.get_data(), dict(request.headers))를, FastAPI에서는 handle_webhook(await request.body(), request.headers)를 사용합니다. 비밀 값을 교체하는 동안에는 둘 다 전달하십시오: [new_secret, old_secret]. 이벤트와 서명 방식은 Webhooks를 참조하십시오.

거래 스크리닝

결제, 출금 또는 암호화폐 송금을 거래 모니터링에 제출하십시오. 응답에는 상태와 위험 점수가 포함됩니다.

Authentication 토큰 검증

didit.authentication은 백엔드에서 Authentication 발급자가 서명한 액세스 토큰을 검사하며, 요청마다 Didit을 호출하지 않습니다. 또한 코드를 교환하고, 토큰을 갱신하며, 세션을 확인하고 폐기하고, 스텝업을 실행합니다.
토큰 검증에서는 서버에서 토큰 검증에 설명된 검사를 애플리케이션의 발급자 및 서명 키를 기준으로 수행합니다.

오류

목록, 파일 및 비동기

API 레퍼런스의 서버 endpoint 페이지에는 각 작업에 대한 Python 샘플이 있습니다. 다만 아직 1.0.1 릴리스에 포함되지 않은 endpoint와 필드는 예외이며, 이는 개요에 명시되어 있습니다.
마지막 수정일 2026년 11월 7일