curl
curl -X GET 'https://verification.didit.me/v3/blocklist/?item_type=document' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
for item in client.blocklist.list():
print(item)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
for await (const item of didit.blocklist.list()) {
console.log(item);
}ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
iter := client.Blocklist.ListAutoPaging(ctx, didit.BlocklistListParams{})
for iter.Next() {
fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
log.Fatal(err)
}import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
for (var item : client.blocklist().list()) {
System.out.println(item);
}<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
foreach ($didit->blocklist->list() as $item) {
print_r($item->toArray());
}require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
didit.blocklist.list.auto_paging_each do |item|
puts item.to_h
endusing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
await foreach (var item in await client.Blocklist.ListAsync())
{
Console.WriteLine(JsonSerializer.Serialize(item));
}{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"type": "document",
"session_id": "33333333-4444-5555-6666-777777777777",
"session_number": 1042,
"blocklisted_at": "2026-10-12T10:06:12.701553Z",
"face_image": null,
"document_type": "ID",
"document_number": "X1234567",
"front_image": "https://media.example.com/documents/front.jpg?expires=1760263938&signature=8b2e47",
"phone_number": null,
"country_code": null,
"email": null
},
{
"type": "phone",
"session_id": "77777777-8888-9999-0000-111111111111",
"session_number": 1017,
"blocklisted_at": "2026-10-08T15:31:09.400127Z",
"face_image": null,
"document_type": null,
"document_number": null,
"front_image": null,
"phone_number": "+14155552671",
"country_code": "US",
"email": null
}
]
}黑名单
黑名单条目列表 API
GET /v3/blocklist/:按最新排序,在一个列表中返回 Didit 会话里已加入黑名单的人脸、证件、电话号码和邮箱。
GET
/
v3
/
blocklist
/
curl
curl -X GET 'https://verification.didit.me/v3/blocklist/?item_type=document' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
for item in client.blocklist.list():
print(item)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
for await (const item of didit.blocklist.list()) {
console.log(item);
}ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
iter := client.Blocklist.ListAutoPaging(ctx, didit.BlocklistListParams{})
for iter.Next() {
fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
log.Fatal(err)
}import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
for (var item : client.blocklist().list()) {
System.out.println(item);
}<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
foreach ($didit->blocklist->list() as $item) {
print_r($item->toArray());
}require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
didit.blocklist.list.auto_paging_each do |item|
puts item.to_h
endusing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
await foreach (var item in await client.Blocklist.ListAsync())
{
Console.WriteLine(JsonSerializer.Serialize(item));
}{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"type": "document",
"session_id": "33333333-4444-5555-6666-777777777777",
"session_number": 1042,
"blocklisted_at": "2026-10-12T10:06:12.701553Z",
"face_image": null,
"document_type": "ID",
"document_number": "X1234567",
"front_image": "https://media.example.com/documents/front.jpg?expires=1760263938&signature=8b2e47",
"phone_number": null,
"country_code": null,
"email": null
},
{
"type": "phone",
"session_id": "77777777-8888-9999-0000-111111111111",
"session_number": 1017,
"blocklisted_at": "2026-10-08T15:31:09.400127Z",
"face_image": null,
"document_type": null,
"document_number": null,
"front_image": null,
"phone_number": "+14155552671",
"country_code": "US",
"email": null
}
]
}
列出您验证会话中当前已加入黑名单的人脸、身份证件、电话号码和邮箱地址,按时间倒序排列(最新的在前)。每一项都指向其来源会话,您可以在控制台中打开该会话,或获取其决策。
此列表仅显示来自会话的黑名单记录:通过添加到黑名单、在控制台中手动添加,或通过从
reference_session_id 创建的名单条目添加。在名单中手动输入的值、已上传的人脸、从证件采集过程中的自拍照中获取的人脸,以及其他类型的条目(地址、设备指纹、钱包、银行账户、用户、企业),仅存在于系统黑名单中。请使用名单条目读取这些记录。
关于黑名单在控制台中的工作方式,请参阅黑名单用户。授权
您的应用 API 密钥,可在 Business Console 的“开发者 -> API 密钥”中获取。主密钥拥有完整访问权限。指定名称的密钥可设置作用域:针对每个资源设为无权限、只读或读写,限定于特定工作流或已通过的会话、限定于 IP 地址列表,以及设置到期日期。401 表示密钥错误、已撤销或已过期;403 表示未发送密钥、密钥无权访问该资源或操作,或请求来自其 IP 列表之外的地址;在会话路由上返回 404 表示该会话不在该密钥允许的工作流或状态范围内。没有媒体访问权限的密钥获取到的图片、视频和 PDF URL 将为 null;没有会话写入权限的密钥获取到的会话链接和 token 将为 null。请参阅 https://docs.didit.me/console/api-keys。
查询参数
仅包含此类型的项。省略时,返回所有类型。
可用选项:
face, document, phone, email 页面大小。默认为 50。大于 1000000 的值返回 400;0、负数或非数字值将回退为 50。
必填范围:
1 <= x <= 1000000要返回的第一项的从零开始的索引。建议跟随 next。大于 1000000 的值将返回 400;负数或非数字值将回退为 0。
必填范围:
0 <= x <= 1000000最后修改于 2026年11月7日