跳转到主要内容
GET
curl
Didit 的“列出银行连接”端点会返回您的连接,并可按状态、访问权限、银行、国家/地区、您自己的引用以及同意到期日期进行筛选。 使用 consent_expires_before 查找需要续期的同意,使用 end_user_reference 查找某个客户的连接。 列表通过 cursor 分页。

授权

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。

查询参数

status
enum<string>

仅限此状态的连接。

可用选项:
pending,
active,
renewal_required,
paused,
revoked,
deleted,
failed
access
enum<string>

仅限此访问模式。

可用选项:
one_time,
ongoing
institution_id
string

仅限此银行。

Maximum string length: 64
country
string

仅限该国家/地区的银行。

Pattern: ^[A-Z]{3}$
vendor_data
string

仅限 vendor_data 为此值的连接。

Maximum string length: 255
end_user_reference
string

仅限 end_user.reference 为此值的连接。

Maximum string length: 255

仅限同意期限在此时间之前结束的连接,例如用于发送续期链接。

created_after
string<date-time>

仅限在此时间之后创建的连接。

limit
integer
默认值:100

每页条数,1 至 500。默认 100。

必填范围: 1 <= x <= 500
cursor
string

不透明游标,取自上一页的 next_cursor。

响应

连接列表的一页。

连接列表的一页。

items
object[]
必填
next_cursor
string | null
必填

作为 cursor 传入以获取下一页。最后一页为 null。

最后修改于 2026年11月22日