跳转到主要内容
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
wallet_address
string

待验证的钱包地址。可选;留空时,必须在启动证明时提供该地址。

Maximum string length: 128
chain
string

地址的链 token,例如 ETH、BTC 或 SOL。请使用与您的钱包地址簿中相同的 token。消息签名和中本聪测试(Satoshi test)仅对受支持的链提供。证明所验证的地址簿条目将其存储在其规范标识符(ETH、BTC、SOL、TRX)下。

Maximum string length: 32
holder_name
string

钱包持有者姓名,用于收款人姓名比对。

Maximum string length: 255
vendor_data
string

您为持有者指定的内部标识符,将带入所创建的地址簿条目中。

Maximum string length: 255
transaction_id
string<uuid> | null

可选。当证明核验通过时需要推进的 Travel Rule 转账的 Didit 交易 UUID。

satoshi_deposit_address
string

可选。您控制的充值地址;提供该地址可启用 SATOSHI_TEST 证明方式。

Maximum string length: 128
callback_url
string

可选。微件在完成后将客户重定向回的绝对 http(s) URL。

Maximum string length: 512
expires_in_minutes
integer
默认值:60

可选。生成的链接的有效期(以分钟为单位)。当提供 SATOSHI_TEST 时,会自动延长以覆盖 Satoshi test 时间窗口。

必填范围: 5 <= x <= 10080

响应

已签发的小部件会话。

widget_session_id
string<uuid>
token
string

嵌入在 widget URL 中的不透明会话 token。

url
string

托管的钱包所有权小部件 URL。请在系统浏览器中原样打开(切勿在移动端 SDK 的 webview 内打开)。

expires_at
string<date-time>
最后修改于 2026年11月7日