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");واجهة إنشاء PDF: تقارير امتثال KYC وKYB
GET /v3/session//generate-pdf/ لتنزيل تقارير امتثال بعلامتك التجارية لجلسات KYC أو KYB. علامة بيضاء، جاهزة للتدقيق، وتسعير حسب الاستخدام - من Didit.
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");دعم KYC وKYB
يعمل هذا مع جلسات التحقق من المستخدمين (KYC) والتحقق من الشركات (KYB). يوجّه Didit الجلسة تلقائياً إلى قالب PDF المناسب:- جلسة التحقق من المستخدمين (KYC) ← تقرير يتضمن أقسام التحقق من الهوية، وكشف الحيوية، ومطابقة الوجه، وAML، وإثبات العنوان.
- جلسة التحقق من الشركات (KYB) ← تقرير يتضمن أقسام سجل الشركات، والأشخاص الرئيسيين (UBOs والمسؤولين)، والمستندات، وAML، والاستبيان، والهاتف، والبريد الإلكتروني، وتحليل عنوان IP، وذلك عندما تكون هذه الميزات جزءاً من سير العمل.
اصطلاح اسم الملف
| النوع | اسم الملف |
|---|---|
| المستخدم | session_<session_id>.pdf |
| الشركة | business_<session_id>.pdf |
Content-Disposition: attachment; filename=....
متطلب الحالة
يجب أن تكون الجلسة في حالةAPPROVED أو DECLINED أو IN_REVIEW لإنشاء ملف PDF. الجلسات قيد التنفيذ أو التي لم تبدأ بعد تُعيد 403.
أمثلة
- ملف PDF للتحقق من المستخدمين (KYC)
- ملف PDF للتحقق من الشركات (KYB)
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 شعارك ورابط سياسة الخصوصية الخاص بك. يُضبط ذلك من Console → Customization.الإذن
يتطلبread:sessions. النطاق نفسه لكلا النوعين.
مواضيع ذات صلة
- نظرة عامة على الجلسات
- استرجاع الجلسة، وهي نسخة JSON من القرار نفسه
- تنزيل PDF لسجل المستخدم، وهو جميع الجلسات القابلة للإدراج في التقرير لمستخدم واحد في ملف واحد
- مخطط استجابة KYB، أي الحقول المضمّنة في ملفات PDF للشركات
التفويضات
مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys.
معلمات المسار
معرّف UUID لجلسة التحقق من المستخدمين (KYC) أو التحقق من الشركات (KYB) المراد عرضها — وهو session_id الذي تم إرجاعه بواسطة POST /v3/session/. يعمل المسار نفسه لكلا نوعي الجلسات؛ استخدم اسم الملف في Content-Disposition بالاستجابة لمعرفة نوع التقرير الذي تلقيته.
يجب أن يكون معرّف UUID منسقاً بشكل سليم وبأحرف صغيرة. يتطابق المسار فقط مع معرّفات UUID الصالحة، لذا يتم رفض أي قيمة غير صحيحة التنسيق بواسطة موجه URL قبل تشغيل أي تعليمات برمجية للتطبيق، وتكون الاستجابة صفحة HTML برمز 404 بدلاً من غلاف JSON {"detail": ...} الموضح أدناه. لا يتطابق محول UUID للمسار إلا مع الصيغة القياسية ذات الأحرف الصغيرة — ويتم رفض معرّفات UUID الست عشرية ذات الأحرف الكبيرة برمز HTML 404.
"11111111-2222-3333-4444-555555555555"
الاستجابة
مستند PDF المُصيَّر، يتم إرجاعه مباشرة كملف ثنائي application/pdf — لا يوجد غلاف JSON ولا إعادة توجيه عبر رابط تنزيل. يبدأ جسم الاستجابة ببايتات %PDF السحرية (PDF 1.7). احفظه في ملف بصيغة .pdf أو مرره مباشرة كبث إلى المتصل بك.
The response is of type file.