跳转到主要内容
GET
curl
Didit 的 List Institutions endpoint可按国家/地区返回银行列表,并说明每家银行支持的内容:细分、持续访问权限、同意期限、历史数据跨度以及返回的字段。 可使用 country、segment、access 和 q 进行过滤。 参见银行覆盖范围。

授权

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。

查询参数

country
string

仅限该国家/地区的银行,使用 ISO 3166-1 alpha-3 代码。Bank Link 不支持的国家/地区会返回 400 invalid_request,并附带 field: country。

Pattern: ^[A-Z]{3}$
segment
enum<string>

仅限服务此细分客群的银行。

可用选项:
personal,
business
access
enum<string>

仅限支持此访问模式的银行。

可用选项:
one_time,
ongoing
q
string

按名称或 id 搜索,不区分大小写。

Maximum string length: 100
limit
integer
默认值:100

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

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

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

响应

银行列表的一页。

items
object[]
必填
next_cursor
string | null
必填
最后修改于 2026年11月22日