跳转到主要内容
POST
cURL
对于启动响应中带有 next_action.type = request_digital_credential 的钱包(例如 Google Wallet),请使用此操作。 请在您的后端使用启动验证时所用的应用 API 密钥进行身份认证。 原样发送钱包返回的内容:浏览器中 navigator.credentials.get 返回的 {protocol, data},或 Android Credential Manager 返回的已解析 credentialJson。 响应已针对 Didit 加密,因此请勿修改。 Didit 会依据受信任的签发方根证书检查签发方签名,依据已签名摘要核对每个返回值,并核验基于您的 origin 与本次请求生成的设备签名,然后决定该验证的结果。 每个响应只能提交一次。再次提交将返回已作出决定的验证结果。 不接受钱包响应的验证会返回 409,并附带 error: "not_a_digital_credentials_wallet"。 完整流程(包括浏览器和 Android 代码示例)请参阅数字身份钱包 API。

授权

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。

路径参数

request_id
string<uuid>
必填

start endpoint 返回的 request_id。

请求体

对于 request_digital_credential 验证,钱包向您的页面或应用返回的内容。

response
object
必填

钱包返回的确切内容:来自 navigator.credentials.get 的 DigitalCredential 的 {protocol, data},或 Android DigitalCredential 解析后的 credentialJson。已为 Didit 加密;切勿修改。

响应

单次独立钱包验证,正如每个钱包 endpoint 返回的结果一样。

request_id
string<uuid>
必填
wallet_verification
object
必填
vendor_data
string | null
必填
metadata
object | null
必填

启动时发送的元数据对象,或 null。

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