curl -X POST 'https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/files-export/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.sessions.export_files(
"11111111-2222-3333-4444-555555555555",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.sessions.exportFiles("11111111-2222-3333-4444-555555555555");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Sessions.ExportFiles(ctx, "11111111-2222-3333-4444-555555555555")
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.sessions().exportFiles("11111111-2222-3333-4444-555555555555");
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->sessions->exportFiles('11111111-2222-3333-4444-555555555555');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.sessions.export_files("11111111-2222-3333-4444-555555555555")
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.ExportFilesAsync("11111111-2222-3333-4444-555555555555");
Console.WriteLine(JsonSerializer.Serialize(result));{
"export_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"session_id": "11111111-2222-3333-4444-555555555555",
"status": "PENDING",
"file_count": null,
"size_bytes": null,
"download_url": null,
"expires_at": null,
"error": null,
"created_at": "2026-10-29T12:00:03Z",
"completed_at": null
}导出会话文件 API:将所有文件打包下载为一个 ZIP
Didit 可将 KYC 或 KYB 会话的所有图片、视频和证件以原始质量打包为一个 ZIP,通过 POST /v3/session//files-export/ 准备导出。
curl -X POST 'https://verification.didit.me/v3/session/11111111-2222-3333-4444-555555555555/files-export/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.sessions.export_files(
"11111111-2222-3333-4444-555555555555",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.sessions.exportFiles("11111111-2222-3333-4444-555555555555");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Sessions.ExportFiles(ctx, "11111111-2222-3333-4444-555555555555")
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.sessions().exportFiles("11111111-2222-3333-4444-555555555555");
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->sessions->exportFiles('11111111-2222-3333-4444-555555555555');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.sessions.export_files("11111111-2222-3333-4444-555555555555")
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.ExportFilesAsync("11111111-2222-3333-4444-555555555555");
Console.WriteLine(JsonSerializer.Serialize(result));{
"export_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"session_id": "11111111-2222-3333-4444-555555555555",
"status": "PENDING",
"file_count": null,
"size_bytes": null,
"download_url": null,
"expires_at": null,
"error": null,
"created_at": "2026-10-29T12:00:03Z",
"completed_at": null
}202 和该导出记录。使用 获取文件导出 读取导出记录,直到 status 变为 READY,然后下载 download_url。
- 当同一会话的导出仍在准备中时,调用会返回该导出,而不会启动新的导出。
- ZIP 在准备就绪 24 小时后删除;删除会话时,ZIP 会立即删除。
- 已删除的会话无法导出,调用返回
404。 - 每次导出都会写入会话的审计日志。
- 限定范围的 API 密钥需要
media: read和decisions: read权限。
授权
您的应用 API 密钥,可在 Business Console 的“开发者 -> API 密钥”中获取。主密钥拥有完整访问权限。指定名称的密钥可设置作用域:针对每个资源设为无权限、只读或读写,限定于特定工作流或已通过的会话、限定于 IP 地址列表,以及设置到期日期。401 表示密钥错误、已撤销或已过期;403 表示未发送密钥、密钥无权访问该资源或操作,或请求来自其 IP 列表之外的地址;在会话路由上返回 404 表示该会话不在该密钥允许的工作流或状态范围内。没有媒体访问权限的密钥获取到的图片、视频和 PDF URL 将为 null;没有会话写入权限的密钥获取到的会话链接和 token 将为 null。请参阅 https://docs.didit.me/console/api-keys。
路径参数
验证会话的 UUID(由 POST /v3/session/ 返回的 session_id)。支持用户验证(KYC)和企业验证(KYB)会话 ID。已删除的会话返回 404。
"11111111-2222-3333-4444-555555555555"
响应
正在准备中的导出。
包含会话中所有原始画质文件的一个 ZIP 包。
导出的 ID。将其传递给 GET /v3/session/{sessionId}/files-export/{exportId}/。
文件所属的会话。
ZIP 准备期间为 PENDING 和 PROCESSING,可供下载后为 READY,无法准备时为 FAILED(请发起新的导出请求),ZIP 被删除后为 EXPIRED。
PENDING, PROCESSING, READY, FAILED, EXPIRED ZIP 包中的文件。仅当 status 为 READY 时设置。
ZIP 文件的大小(字节)。仅在 status 为 READY 时设置。
ZIP 文件的签名 URL,短期内有效。仅在 status 为 READY 时设置;如需新的 URL,请重新读取该导出。
ZIP 文件的删除时间,为生成就绪后 24 小时。仅当 status 为 READY 时设置。
当 status 为 FAILED 时,导出失败的原因。
请求导出的时间。
ZIP 文件就绪或导出失败的时间。