メインコンテンツへスキップ
Java・Kotlin向けのDidit公式ライブラリです。Java 11以降が必要で、依存関係はjava.net.http、Jackson、JSpecifyのnullnessアノテーションのみです。すべてのメソッドには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リファレンスページのスニペットはメソッドの本体であり、必要なインポートをその上に記載しています。

セッションを作成する

ワークフローの認証セッションを作成し、ユーザーをそのURLに誘導します。

判定を読み取る

ユーザーが完了したとき(またはWebhookが届いたとき)、判定を読み取ります。各機能の結果はリストで、ワークフローのノードごとに1件のエントリーがあります。

Webhookを検証する

受信したままの生のボディとリクエストヘッダーを渡します。Webhooks.verifyは、有効かつ期限内の配信以外の場合に対してはWebhookVerificationExceptionをスローし、それ以外の場合は型付きのイベントを返します。
Spring Bootでは、ボディを@RequestBody byte[] body、ヘッダーを@RequestHeader Map<String, String> headersとして受け取ります。シークレットのローテーション中に2つのシークレットを受け入れるには、VerifyOptionsを渡します。イベントと署名方式についてはWebhookを参照してください。

取引をスクリーニングする

支払い、出金、暗号資産の送金をトランザクションモニタリングに送信します。レスポンスにはそのステータスとリスクスコアが含まれます。

Authenticationトークンを検証する

Authenticationは、Authenticationの発行者が署名したアクセストークンを、リクエストごとにDiditを呼び出すことなくバックエンドで検証します。また、コードの交換、トークンの更新、セッションの確認と無効化、ステップアップの実行も行います。
トークン検証では、アプリケーションの発行者と署名鍵に照らして、サーバーでトークンを検証するに記載されたチェックを行います。

エラー

すべての例外は非チェック例外のDiditExceptionを継承しています。

リストとファイル

APIリファレンスのサーバーエンドポイントのページには、各操作のJavaサンプルがあります。ただし、概要に記載された、まだどの1.0.1リリースにも含まれていないエンドポイントとフィールドは除きます。
最終更新日 2026年11月1日