Python
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.sessions.upload_kyb_documents(
"33333333-4444-5555-6666-777777777777",
documents=[open("document.pdf", "rb")],
)
print(result)import Didit, { fileFromPath } from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.sessions.uploadKybDocuments("33333333-4444-5555-6666-777777777777", {
documents: [await fileFromPath("document.pdf")],
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Sessions.UploadKYBDocuments(ctx, "33333333-4444-5555-6666-777777777777", didit.SessionsUploadKYBDocumentsParams{
Documents: []didit.File{didit.FileFromPath("document.pdf")},
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import java.nio.file.Path;
import java.util.List;
import me.didit.Didit;
import me.didit.types.SessionsUploadKybDocumentsParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.sessions().uploadKybDocuments("33333333-4444-5555-6666-777777777777", SessionsUploadKybDocumentsParams.builder()
.documents(List.of(Path.of("document.pdf")))
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
use Didit\File;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->sessions->uploadKybDocuments('33333333-4444-5555-6666-777777777777', [
'documents' => [File::fromPath('document.pdf')],
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.sessions.upload_kyb_documents(
"33333333-4444-5555-6666-777777777777",
documents: [Pathname("document.pdf")]
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Sessions.UploadKybDocumentsAsync("33333333-4444-5555-6666-777777777777", new SessionsUploadKybDocumentsParams
{
Documents = new FileUpload[] { FileUpload.FromPath("document.pdf") },
});
Console.WriteLine(JsonSerializer.Serialize(result));curl --request POST \
--url https://verification.didit.me/v3/session/{sessionId}/kyb/documents/ \
--header 'Content-Type: multipart/form-data' \
--header 'x-api-key: <api-key>' \
--form documents=@example-file \
--form 'document_passwords=<string>' \
--form 'locale=<string>'{
"valid": true,
"next_step": "KYB_KEY_PEOPLE",
"kyb_status": "In Progress"
}用户与企业验证
KYB 证件上传 API:企业验证文件上传接口
通过您自己的服务器将企业证件上传至 Didit 企业验证会话,并使用托管流程的 OCR 与核验功能。
POST
/
v3
/
session
/
{sessionId}
/
kyb
/
documents
/
Python
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.sessions.upload_kyb_documents(
"33333333-4444-5555-6666-777777777777",
documents=[open("document.pdf", "rb")],
)
print(result)import Didit, { fileFromPath } from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.sessions.uploadKybDocuments("33333333-4444-5555-6666-777777777777", {
documents: [await fileFromPath("document.pdf")],
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Sessions.UploadKYBDocuments(ctx, "33333333-4444-5555-6666-777777777777", didit.SessionsUploadKYBDocumentsParams{
Documents: []didit.File{didit.FileFromPath("document.pdf")},
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import java.nio.file.Path;
import java.util.List;
import me.didit.Didit;
import me.didit.types.SessionsUploadKybDocumentsParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.sessions().uploadKybDocuments("33333333-4444-5555-6666-777777777777", SessionsUploadKybDocumentsParams.builder()
.documents(List.of(Path.of("document.pdf")))
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
use Didit\File;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->sessions->uploadKybDocuments('33333333-4444-5555-6666-777777777777', [
'documents' => [File::fromPath('document.pdf')],
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.sessions.upload_kyb_documents(
"33333333-4444-5555-6666-777777777777",
documents: [Pathname("document.pdf")]
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Sessions.UploadKybDocumentsAsync("33333333-4444-5555-6666-777777777777", new SessionsUploadKybDocumentsParams
{
Documents = new FileUpload[] { FileUpload.FromPath("document.pdf") },
});
Console.WriteLine(JsonSerializer.Serialize(result));curl --request POST \
--url https://verification.didit.me/v3/session/{sessionId}/kyb/documents/ \
--header 'Content-Type: multipart/form-data' \
--header 'x-api-key: <api-key>' \
--form documents=@example-file \
--form 'document_passwords=<string>' \
--form 'locale=<string>'{
"valid": true,
"next_step": "KYB_KEY_PEOPLE",
"kyb_status": "In Progress"
}授权
您的应用 API 密钥,可在 Business Console 的“开发者 -> API 密钥”中获取。主密钥拥有完整访问权限。指定名称的密钥可设置作用域:针对每个资源设为无权限、只读或读写,限定于特定工作流或已通过的会话、限定于 IP 地址列表,以及设置到期日期。401 表示密钥错误、已撤销或已过期;403 表示未发送密钥、密钥无权访问该资源或操作,或请求来自其 IP 列表之外的地址;在会话路由上返回 404 表示该会话不在该密钥允许的工作流或状态范围内。没有媒体访问权限的密钥获取到的图片、视频和 PDF URL 将为 null;没有会话写入权限的密钥获取到的会话链接和 token 将为 null。请参阅 https://docs.didit.me/console/api-keys。
路径参数
企业验证(KYB)会话的 UUID。它必须属于 API 密钥所属的应用。
示例:
"33333333-4444-5555-6666-777777777777"
查询参数
KYB 步骤的工作流节点。仅在工作流具有多个 KYB 节点时需要;默认情况下,Didit 会使用会话自身的节点。
请求体
multipart/form-data
待上传的文件:JPG、JPEG、PNG、TIFF、WEBP、PDF 或它们的 ZIP 压缩包。PDF 最大 50 MB,照片压缩前最大 6 MB。
documents 中的每个文件按相同顺序对应一个条目:受密码保护的 PDF 填写密码,其他任何文件留空。
此上传所对应的必需证件组。
可用选项:
LEGAL_PRESENCE, COMPANY_DETAILS, OWNERSHIP_STRUCTURE, REPRESENTATIVES_AUTHORIZATION 用于翻译下一步响应的区域设置。
Maximum string length:
10最后修改于 2026年11月7日