curl --fail \
https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/generate-pdf/ \
-H 'x-api-key: YOUR_API_KEY' \
--output report.pdffrom didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
content = client.sessions.generate_pdf(
"11111111-2222-3333-4444-555555555555",
)
with open("download.pdf", "wb") as file:
file.write(content)import { writeFile } from "node:fs/promises";
import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const content = await didit.sessions.generatePdf("11111111-2222-3333-4444-555555555555");
await writeFile("download.pdf", Buffer.from(await content.arrayBuffer()));ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
resp, err := client.Sessions.GeneratePDF(ctx, "11111111-2222-3333-4444-555555555555")
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
file, err := os.Create("download.pdf")
if err != nil {
log.Fatal(err)
}
defer file.Close()
if _, err := io.Copy(file, resp.Body); err != nil {
log.Fatal(err)
}import java.nio.file.Path;
import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
client.sessions().generatePdf("11111111-2222-3333-4444-555555555555")
.writeTo(Path.of("download.pdf"));<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$content = $didit->sessions->generatePdf('11111111-2222-3333-4444-555555555555');
$content->saveTo('download.pdf');require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
content = didit.sessions.generate_pdf("11111111-2222-3333-4444-555555555555")
File.binwrite("download.pdf", content)using System;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var content = await client.Sessions.GeneratePdfAsync("11111111-2222-3333-4444-555555555555");
await content.SaveToAsync("download.pdf");"<string>"PDF生成API:KYC・KYBコンプライアンスレポート
DiditのGET /v3/session//generate-pdf/で、KYCまたはKYBセッションのブランド入りコンプライアンスレポートをダウンロードできます。ホワイトラベル対応、監査に対応、従量課金制。
curl --fail \
https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/generate-pdf/ \
-H 'x-api-key: YOUR_API_KEY' \
--output report.pdffrom didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
content = client.sessions.generate_pdf(
"11111111-2222-3333-4444-555555555555",
)
with open("download.pdf", "wb") as file:
file.write(content)import { writeFile } from "node:fs/promises";
import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const content = await didit.sessions.generatePdf("11111111-2222-3333-4444-555555555555");
await writeFile("download.pdf", Buffer.from(await content.arrayBuffer()));ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
resp, err := client.Sessions.GeneratePDF(ctx, "11111111-2222-3333-4444-555555555555")
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
file, err := os.Create("download.pdf")
if err != nil {
log.Fatal(err)
}
defer file.Close()
if _, err := io.Copy(file, resp.Body); err != nil {
log.Fatal(err)
}import java.nio.file.Path;
import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
client.sessions().generatePdf("11111111-2222-3333-4444-555555555555")
.writeTo(Path.of("download.pdf"));<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$content = $didit->sessions->generatePdf('11111111-2222-3333-4444-555555555555');
$content->saveTo('download.pdf');require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
content = didit.sessions.generate_pdf("11111111-2222-3333-4444-555555555555")
File.binwrite("download.pdf", content)using System;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var content = await client.Sessions.GeneratePdfAsync("11111111-2222-3333-4444-555555555555");
await content.SaveToAsync("download.pdf");"<string>"KYCとKYBのサポート
本人確認(KYC)と法人確認 (KYB)の両方のセッションで利用できます。Diditが適切なPDFテンプレートを自動的に選択します。- 本人確認(KYC)セッション → 本人確認、ライブネス検知、顔照合、AMLスクリーニング、住所証明の各セクションを含むレポート。
- 法人確認 (KYB)セッション → 法人登記、主要人物(UBO/役員)、書類、AMLスクリーニング、アンケート、電話番号、メールアドレス、IP分析の各セクションを含むレポート(それらの機能がワークフローに含まれている場合)。
ファイル名の規則
| 種類 | ファイル名 |
|---|---|
| ユーザー | session_<session_id>.pdf |
| 企業 | business_<session_id>.pdf |
Content-Disposition: attachment; filename=...ヘッダーで返されます。
ステータスの要件
PDFを生成するには、セッションがAPPROVED、DECLINED、IN_REVIEWのいずれかである必要があります。進行中または未開始のセッションでは403が返されます。
例
- 本人確認(KYC)のPDF
- 法人確認 (KYB)のPDF
curl https://verification.didit.me/v3/session/4c5c7f3a-.../generate-pdf/ \
-H "x-api-key: YOUR_API_KEY" \
-o kyc-report.pdf
curl https://verification.didit.me/v3/session/bs-01HJX1.../generate-pdf/ \
-H "x-api-key: YOUR_API_KEY" \
-o kyb-report.pdf
ホワイトラベル
アプリケーションでホワイトラベルのカスタマイズが有効になっている場合、PDFには貴社のロゴとプライバシーポリシーのURLが表示されます。Console → Customizationで設定します。権限
read:sessionsが必要です。どちらの種類でも同じスコープです。
関連情報
- セッションの概要
- セッションの取得:同じ判定のJSON版
- ユーザー履歴PDFのダウンロード:1人のユーザーのレポート対象となるすべてのセッションを1つのファイルにまとめたもの
- KYBレスポンススキーマ:企業向けPDFに含まれるフィールド
承認
お客様のアプリケーションのAPIキーです。Business ConsoleのDevelopers -> API keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権(なし、読み取り、書き込み)、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください: https://docs.didit.me/console/api-keys
パスパラメータ
レンダリングするユーザー認証 (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.