メインコンテンツへスキップ
GET
cURL

KYCとKYBのサポート

本人確認(KYC)と法人確認 (KYB)の両方のセッションで利用できます。Diditが適切なPDFテンプレートを自動的に選択します。
  • 本人確認(KYC)セッション → 本人確認、ライブネス検知、顔照合、AMLスクリーニング、住所証明の各セクションを含むレポート。
  • 法人確認 (KYB)セッション → 法人登記、主要人物(UBO/役員)、書類、AMLスクリーニング、アンケート、電話番号、メールアドレス、IP分析の各セクションを含むレポート(それらの機能がワークフローに含まれている場合)。
どちらも同じPDF生成パイプラインを使用し、ホワイトラベルのカスタマイズ(ロゴ、プライバシーポリシーのURL)に対応しています。

ファイル名の規則

Content-Disposition: attachment; filename=...ヘッダーで返されます。

ステータスの要件

PDFを生成するには、セッションがAPPROVED、DECLINED、IN_REVIEWのいずれかである必要があります。進行中または未開始のセッションでは403が返されます。

例

ホワイトラベル

アプリケーションでホワイトラベルのカスタマイズが有効になっている場合、PDFには貴社のロゴとプライバシーポリシーのURLが表示されます。Console → Customizationで設定します。

権限

read:sessionsが必要です。どちらの種類でも同じスコープです。

関連情報

承認

x-api-key
string
header
必須

お客様のアプリケーションのAPIキーです。Business ConsoleのDevelopers -> API keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権(なし、読み取り、書き込み)、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください: https://docs.didit.me/console/api-keys

パスパラメータ

sessionId
string<uuid>
必須

レンダリングするユーザー認証 (KYC) または法人確認 (KYB) セッションのUUIDで、POST /v3/session/が返すsession_idです。同じパスで両方の種類のセッションに対応します。受け取ったレポートの種類は、レスポンスのContent-Dispositionのファイル名で判別してください。

正しい形式の小文字のUUIDである必要があります。 このルートは有効なUUIDにのみ一致するため、不正な値はアプリケーションコードが実行される前にURLルーターで拒否され、レスポンスは下記のJSONの{"detail": ...}エンベロープではなく404のHTMLページになります。ルートのUUIDコンバーターは正規の小文字形式にのみ一致するため、16進数が大文字のUUIDはHTMLの404で拒否されます。

例:

"11111111-2222-3333-4444-555555555555"

レスポンス

レンダリングされたPDF書類。バイナリのapplication/pdfとして直接返されます。JSONラッパーやダウンロードURLを介した間接参照はありません。本文は%PDFのマジックバイト(PDF 1.7)で始まります。.pdfファイルに保存するか、呼び出し元にそのままストリーミングしてください。

The response is of type file.

最終更新日 2026年11月1日