跳转到主要内容
DELETE
curl
Didit 的删除银行连接 endpoint 会停止银行侧的访问权限,并删除该连接中存储的账户、余额和交易数据。 删除操作不可撤销。 如果只想停止访问而不删除数据,请使用撤销。 有关哪些内容会受影响、哪些不会受影响,请参阅数据、同意与删除。

授权

x-api-key
string
header
必填

您的应用 API 密钥,可在 Business Console 的开发者 -> API 密钥中获取。主密钥拥有完全访问权限。命名密钥可以设置范围:可按资源设置无权限、只读或读写,可限定为部分工作流或已批准的会话,可限定为一组 IP 地址,并可设置过期日期。401 表示密钥错误、已被撤销或已过期;403 表示未发送密钥、密钥无权访问该资源或执行该操作,或请求来自其 IP 列表之外的地址;会话相关路由返回 404,表示该会话不在密钥的工作流或状态范围内。没有媒体访问权限的密钥会将图片、视频和 PDF 的 URL 返回为 null;没有会话写入权限的密钥会将会话链接和令牌返回为 null。请参阅 https://docs.didit.me/console/api-keys。

请求头

Idempotency-Key
string

您为单次操作选择的可选重试安全密钥,最长 255 个字符(可使用 UUID)。使用相同密钥、endpoint、查询参数和请求体重复发送的请求,会返回第一次的响应,状态码和响应体均相同,且不会再次运行或计费。同一密钥若用于其他 endpoint、查询参数或请求体,将返回 409 idempotency_key_reused;若第一个请求仍在处理中,则返回 409 idempotency_key_in_progress 及 Retry-After。失败的请求(任何 4xx 或 5xx)不会被存储,因此您可以使用相同密钥再次发送。无论您使用 API 密钥还是访问 token 调用,密钥都归属于您的应用。请参阅重试与幂等性。

Required string length: 1 - 255

路径参数

id
string<uuid>
必填

连接 ID。

响应

已接受删除请求。

已接受删除请求。连接的银行数据正在删除,其数据操作将返回 409 connection_not_active;读取该连接时,将返回包含此 erasure 状态的最简记录。

id
string<uuid>
必填

连接 ID。

erasure
object
必填

您申请的删除操作的进度。

最后修改于 2026年11月22日