curl
curl -X POST 'https://verification.didit.me/v3/blocklist/add/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"session_id": "33333333-4444-5555-6666-777777777777",
"blocklist_face": true,
"blocklist_document": true
}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.blocklist.add(
session_id="33333333-4444-5555-6666-777777777777",
blocklist_face=True,
blocklist_document=True,
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.blocklist.add({
session_id: "33333333-4444-5555-6666-777777777777",
blocklist_face: true,
blocklist_document: true,
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Blocklist.Add(ctx, didit.BlocklistAddParams{
SessionID: "33333333-4444-5555-6666-777777777777",
BlocklistFace: didit.Bool(true),
BlocklistDocument: didit.Bool(true),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.BlocklistAddParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.blocklist().add(BlocklistAddParams.builder()
.sessionId("33333333-4444-5555-6666-777777777777")
.blocklistFace(true)
.blocklistDocument(true)
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->blocklist->add([
'session_id' => '33333333-4444-5555-6666-777777777777',
'blocklist_face' => true,
'blocklist_document' => true,
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.blocklist.add(
session_id: "33333333-4444-5555-6666-777777777777",
blocklist_face: true,
blocklist_document: true
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Blocklist.AddAsync(new BlocklistAddParams
{
SessionId = "33333333-4444-5555-6666-777777777777",
BlocklistFace = true,
BlocklistDocument = true,
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"message": "Successfully updated blocklist."
}黑名单
加入黑名单 API:拉黑会话项
POST /v3/blocklist/add/:将 Didit 验证会话中的人脸、证件、电话号码或邮箱加入黑名单,使匹配的新会话被拒绝。
POST
/
v3
/
blocklist
/
add
/
curl
curl -X POST 'https://verification.didit.me/v3/blocklist/add/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"session_id": "33333333-4444-5555-6666-777777777777",
"blocklist_face": true,
"blocklist_document": true
}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.blocklist.add(
session_id="33333333-4444-5555-6666-777777777777",
blocklist_face=True,
blocklist_document=True,
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.blocklist.add({
session_id: "33333333-4444-5555-6666-777777777777",
blocklist_face: true,
blocklist_document: true,
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Blocklist.Add(ctx, didit.BlocklistAddParams{
SessionID: "33333333-4444-5555-6666-777777777777",
BlocklistFace: didit.Bool(true),
BlocklistDocument: didit.Bool(true),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
import me.didit.types.BlocklistAddParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.blocklist().add(BlocklistAddParams.builder()
.sessionId("33333333-4444-5555-6666-777777777777")
.blocklistFace(true)
.blocklistDocument(true)
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->blocklist->add([
'session_id' => '33333333-4444-5555-6666-777777777777',
'blocklist_face' => true,
'blocklist_document' => true,
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.blocklist.add(
session_id: "33333333-4444-5555-6666-777777777777",
blocklist_face: true,
blocklist_document: true
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Blocklist.AddAsync(new BlocklistAddParams
{
SessionId = "33333333-4444-5555-6666-777777777777",
BlocklistFace = true,
BlocklistDocument = true,
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"message": "Successfully updated blocklist."
}
将一次验证会话收集的人脸、身份证件、电话号码或电子邮箱地址加入黑名单。Didit 会将每条所选记录标记为已加入黑名单,并将其添加到对应的系统黑名单中,并与该会话关联。此后,人脸、证件号码、电话号码或电子邮箱地址与黑名单匹配的新会话都会被拒绝。
如需查看当前被封禁的内容,请使用列出已加入黑名单的项目。如需解除封禁,请使用从黑名单中移除。如需封禁 IP 地址、设备指纹、用户、企业或不关联会话的值,请使用创建条目将其添加到对应的系统黑名单中。有关黑名单的执行方式,请参阅用户黑名单。
该调用要么全部成功,要么全部不执行:如果会话中没有所选类型的记录,或证件缺少签发国家/地区、证件类型、证件号码或姓名,接口将返回
400,且不会加入任何黑名单。对已在黑名单中的项目重复调用是安全的。授权
您的应用 API 密钥,可在 Business Console 的“开发者 -> API 密钥”中获取。主密钥拥有完整访问权限。指定名称的密钥可设置作用域:针对每个资源设为无权限、只读或读写,限定于特定工作流或已通过的会话、限定于 IP 地址列表,以及设置到期日期。401 表示密钥错误、已撤销或已过期;403 表示未发送密钥、密钥无权访问该资源或操作,或请求来自其 IP 列表之外的地址;在会话路由上返回 404 表示该会话不在该密钥允许的工作流或状态范围内。没有媒体访问权限的密钥获取到的图片、视频和 PDF URL 将为 null;没有会话写入权限的密钥获取到的会话链接和 token 将为 null。请参阅 https://docs.didit.me/console/api-keys。
请求体
application/json
响应
所选项目已被列入黑名单。
始终为 Successfully updated blocklist.
最后修改于 2026年11月7日