메인 콘텐츠로 건너뛰기
공식 Didit 라이브러리는 Java와 Kotlin용입니다. Java 11 이상이 필요하며, java.net.http, Jackson, JSpecify 널 가능성 어노테이션에만 의존합니다. 모든 메서드에는 CompletableFuture를 반환하는 ...Async 변형이 있습니다. 모든 서버 SDK가 공유하는 내용은 서버 SDK 개요를 참조하세요.

설치

아티팩트는 Maven Central의 me.didit:didit-java입니다. 소스와 변경 로그는 GitHub의 didit-protocol/sdk-java에 있습니다.

클라이언트 구성

new Didit()은 환경 변수에서 DIDIT_API_KEY를 읽습니다. 이 값을 재정의하려면 빌더를 사용하세요. 애플리케이션 범위 호출(케이스, 네트워크, 규제 보고서)에 필요한 조직 ID와 애플리케이션 ID를 설정할 때도 빌더를 사용합니다.
요청 타입은 빌더이며, 빌더의 build()는 필수 필드를 확인합니다. 선택적 응답 필드는 Optional 값입니다. Kotlin에서는 .getOrNull()로 읽습니다. 이 페이지와 각 API 레퍼런스 페이지의 코드 조각은 메서드 본문이며, 필요한 import는 그 위에 있습니다.

세션 생성

워크플로에 대한 인증 세션을 생성하고 사용자를 해당 URL로 이동시키세요.

결정 읽기

사용자가 절차를 마치면(또는 webhook이 도착하면) 결정을 읽으세요. 모든 기능 결과는 워크플로 노드당 하나의 항목을 가진 목록입니다.

webhook 검증

원본 본문을 수신한 그대로 요청 헤더와 함께 전달하세요. Webhooks.verify는 유효하지 않거나 최신이 아닌 전송에 대해 WebhookVerificationException을 던지며, 그 밖의 경우에는 타입이 지정된 이벤트를 반환합니다.
Spring Boot에서는 본문을 @RequestBody byte[] body로, 헤더를 @RequestHeader Map<String, String> headers로 받으세요. 키를 교체하는 동안 두 개의 시크릿을 허용하려면 VerifyOptions를 전달하세요. 이벤트와 서명 방식은 Webhooks를 참조하세요.

거래 스크리닝

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

Authentication 토큰 검증

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

오류

모든 예외는 비검사 예외인 DiditException을 상속합니다.

목록 및 파일

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