Didit連携ガイド：API・SDK・Webhook

アプリにDiditを組み込む: API、SDK、Webhook (開発者ガイド) の全文の書き起こしです。Didit Academy動画全10本中の8本目、08:13。YouTubeで視聴。各段落は動画内の該当箇所にリンクしています。

​

この動画で組み込むもの

00:04 この動画では、Diditを自社のアプリに組み込みます。これにより、ユーザーはプロダクト内でそのまま認証を行え、すべての結果が発生した瞬間にシステムへ返されます。開発者向けの動画なので少し技術的ですが、思っているよりシンプルです。最後まで見れば、その大部分をそのままClaude Codeに任せて構築してもらえることがわかるはずです。では、実際に構築する順番に沿って進めていきます。

​

SDK・API・Webhookの3つの要素

00:28 実際に構築する方法を見ていきましょう。さっそく始めます。Diditの連携とは、3つの要素をつなぐことです。SDKは、カメラ、書類の撮影、NFCの読み取り、ライブネスのUIをアプリ内で直接表示します。APIはサーバー間通信で、バックエンドがセッションを作成し、最終的な判定を取得します。そしてWebhookは、セッションの状態が変わった瞬間にHTTPSエンドポイントを呼び出します。これはポーリングで取得するよりも

​

連携タブ

00:56 ポーリングよりもはるかに高速で、得られる情報も豊富です。最も簡単な連携方法は、管理タブに移動して「連携」をクリックすることです。ここからすべての設定を取得でき、APIキーも取得できます。作業中のこのアプリ専用のAPIキーを設定することもできます。連携したいワークフローを作成して選択できます。Webhookも追加できます。ここが認証結果の送信先になります。 01:24 そして署名シークレットは、この後すぐにお見せしますが、これが

​

プラットフォームの選択

01:28 ENVファイルに入れます。次に、アプリに連携できます。ここにはいくつかの選択肢があります。Web JS、React Native、iOS、Android、Flutterのほか、いくつかのプラットフォームが用意されています。アプリに合ったものを選択してください。これが、ENVファイルに入れる環境シークレットです。配置先は

​

AIセットアッププロンプト

01:48 サーバー側です。これを簡単に設定するには、AIセットアッププロンプトを使います。ここで設定をすべて構成してからプロンプトをコピーすると、ここで完了した設定から必要な情報がすべてコピーされます。これをコピーして、Cloud CodeやCodexなど、アプリを

​

APIキーは環境ごとに1つ

02:09 アプリケーションを構築する際に使用します。APIキーはここにあり、各行に1つのキーがあります。良い習慣として、連携ごと・環境ごとに別々のキーを用意しましょう。そうすれば、他のキーに影響を与えずに1つのキーをローテーションしたり失効させたりできます。たとえば特定のワークフローを連携する場合は、

​

キーの作成

02:27 そのワークフロー専用のAPIキーを用意するとよいでしょう。では「APIキーを作成」をクリックして、ここでは「test」と入力し、APIキーを作成します。これでコピーできますが、二度と表示されません。そのため、必ずコピーして、連携作業で使えるようにどこかに控えておくことが大切です。連携セクションに移ってAPIキーを取得します。たとえばtestキーを選んで下にスクロールし、このKYCワークフローを使うことにします。Webhookも追加できます。 03:05 アプリを接続できます。そして、ここにこのセットアッププロンプトを入力できます。ご覧のとおり、このプロンプトには

​

Webhookの概要

03:13 APIキーが含まれます。では、Webhookについて簡単に見ていきましょう。Webhookは基本的に、どのような目的にも設定できます。たとえば特定のイベントをSlackに送りたい場合、

​

ドキュメント

03:25 ここにWebhook URLを追加してください。では、ドキュメントを見てみましょう。技術ドキュメントはすべて利用できます。docs.didit.meにアクセスして、いくつかの項目を

​

セッション作成と唯一の必須フィールド

03:37 見ていきます。すべての中心になるのがセッション作成です。これはPOSTリクエストで、認証の開始にあたります。curlリクエストを見ると、ワークフローIDがあります。これが唯一の必須フィールドで、非常に便利なのは、この同じエンドポイントでKYCとKYBの両方のセッションを作成できることです。どちらになるかは

​

ベンダーデータとコールバックURL

04:00 ワークフローで決まります。下には追加のフィールドがあり、このシリーズで何度も説明してきたベンダーデータも含まれます。これは各ユーザーの一意の識別子で、メールアドレスでも一意のIDでも自由に定義できます。そしてコールバックURLがあります。これは、ユーザーが認証ワークフローを完了した後に遷移する先です。

​

エンドポイントを実際に試す

04:24 下にスクロールすると、実際に試すことができます。「Try it」をクリックすると、ここで認証セッションを作成できます。APIキーを1つ入力します。新しいキーを「test two」として作成し、コピーしてここに貼り付けます。ワークフローIDも必要なので、こちらに移動して、このワークフローIDを取得し、ここに入力します。ベンダーデータは必須ではありません。ランダムな数字列を入れておきましょう。 05:02 コールバックURLはそのままで大丈夫です。ちなみに、これらはどれも必須ではありません。テストアカウントを使っているからだと思いますが、このエンドポイントをテストしたい場合は、まさにこの方法でテストできます。開発者で具体的な答えが必要な場合は、ドキュメントを確認してください。MCPもこれらすべてのドキュメントにアクセスできるため、MCPを連携して、これらのドキュメントに記載されている可能性が高い技術的な質問をClaudeに質問するだけで済みます。

​

ポーリングではなくWebhookを使う理由

05:32 ここで、では、Webhookについて説明しましょう。管理セクションにWebhook用のタブがあり、実際の結果はここを通じて届きます。ポーリングはかなり遅いため、Webhookが推奨されるチャネルです。さらにポーリングは

​

送信先の追加とイベントの選択

05:44 リクエスト数も多くなり、イベントを取りこぼすこともあります。では、ここで新しい送信先を追加します。URLを貼り付け、受け取りたいイベントを選択します。これが、このエンドポイントに送信するすべてのデータです。Diditからは一度だけ表示される署名シークレットが発行されます。これはこのあとお見せします。なお、URLには外部から直接アクセスできる必要があります。localhostやプライベートIPは使えません。それでは、この画面を閉じて右側にスクロールすると、いくつかのオプションがあります。 06:16 ここでは、このWebhookが受信するイベントの数を確認できます。また、

​

署名シークレット

06:19 署名シークレットをコピーしてください。これは連携において重要になります。連携タブで連携をセットアップする際にプロンプトがあることを先ほどご説明しましたが、そのセットアップで選択したWebhookの署名シークレットがここに含まれます。それでは、

​

Webhookハンドラー用のプロンプト

06:34 AIを活用するもう一つの方法をご紹介します。Webhooksタブに、あらかじめ用意されたプロンプトがあります。AIでWebhookハンドラーをセットアップしたい場合に使えます。ドキュメントを開くと、連携用のプロンプトが見つかります。このプロンプトは本人確認、エンティティ、取引をカバーしていて、すべてを自動で構築してくれます。構築する内容、検証用の署名ヘッダー、先ほどWebhookを設定したときに見たWebhookイベントの種類、Webhookのエンベロープなど、多くの内容が整理されています。さらに、貼り付け先として使用するツールも選択できます。 07:15 このプロンプトを使えば、手軽に始めて連携をセットアップできます。MCPサーバーを連携すれば、この動画でご説明した内容はすべて、AIツールの中から参照・照会できます。実現したいことを平易な英語で伝えるだけで、Claude Codeがドキュメントを読み、連携を構築してくれます。あなたが行うのは作業内容の確認と、正しく実行され

​

まとめ

07:41 すべてをゼロからコーディングするのではなく、動作するものを活用しましょう。以上が、アプリにDiditを組み込む方法です。ユーザーが目にするSDK、バックエンドが呼び出すAPI、そして判定を届け、その判定をもとに処理を組み立てるための署名付きWebhookです。Webhookを信頼し、ベンダー提供のデータをあらゆる場所で使い、セットアッププロンプトを活用して、面倒な部分を手作業で組み込まずに済ませましょう。didit.meで無料登録すれば、数分で認証を実行できます。