跳转到主要内容
POST
curl

授权

x-api-key
string
header
必填

您的应用 API 密钥,可在 Business Console 的“开发者 -> API 密钥”中获取。主密钥拥有完整访问权限。指定名称的密钥可设置作用域:针对每个资源设为无权限、只读或读写,限定于特定工作流或已通过的会话、限定于 IP 地址列表,以及设置到期日期。401 表示密钥错误、已撤销或已过期;403 表示未发送密钥、密钥无权访问该资源或操作,或请求来自其 IP 列表之外的地址;在会话路由上返回 404 表示该会话不在该密钥允许的工作流或状态范围内。没有媒体访问权限的密钥获取到的图片、视频和 PDF URL 将为 null;没有会话写入权限的密钥获取到的会话链接和 token 将为 null。请参阅 https://docs.didit.me/console/api-keys。

请求体

application/json
counterparty
string<uuid>
必填

目录条目的 id。

email
string<email>
必填
Maximum string length: 254
name
string

可选标签。

Maximum string length: 255

响应

联系人已添加。

EMAIL 渠道写入单个名录条目的合规地址。

uuid
string<uuid>
counterparty
string<uuid>

目录条目的 id,如 GET /v3/travel-rule/vasps/ 所显示。

counterparty_name
string
email
string<email>
name
string

可选标签,例如团队名称。

source
enum<string>

staff:由 Didit 维护。learned:该 VASP 自身域名下的地址,通过其响应链接回复了请求。application:由您的应用添加。

可用选项:
staff,
application,
learned
scope
enum<string>

platform:由 Didit 整理或从已验证的响应中获取,供所有 Didit 客户使用,对您而言为只读。application:对您的应用私有。

可用选项:
platform,
application
created_by
string

对于平台联系人和通过 API 密钥添加的联系人,该项为空。

verified_at
string<date-time> | null

此地址上次通过其响应链接回复请求的时间。

is_invalid
boolean

一旦地址发生退信或投诉,则为 true;EMAIL 通道会跳过该地址。

invalid_reason
enum<string>
可用选项:
,
hard_bounce,
soft_bounce,
spam_complaint,
suppressed
invalid_detail
string

接收邮件服务器返回的原因(如有)。

invalid_at
string<date-time> | null
created_at
string<date-time>
最后修改于 2026年11月7日