跳转到主要内容
GET
curl
Didit 的 Get an Institution endpoint 会返回一家银行的信息,包括其能力和健康状况。从未观测到的值为 null,而不是猜测的值。

授权

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。

路径参数

id
string
必填

机构 ID,例如 es-banco-norte。

响应

银行。

银行及其支持的功能。取值来自已观察到的能力数据,每日刷新;从未观察到的值为 null,而不是猜测值。

id
string
必填

Didit 的银行标识符,为稳定的 slug。

示例:

"es-banco-norte"

name
string
必填
country
string
必填
Pattern: ^[A-Z]{3}$
logo_url
string<uri> | null
必填
timezone
string | null
必填

银行日期所使用的 IANA 时区。

segments
enum<string>[]
必填
可用选项:
personal,
business
access
enum<string>[]
必填

只有对该银行开启了持续访问时,才会列出 ongoing。

可用选项:
one_time,
ongoing
ongoing_access
boolean
必填

该银行是否支持持续访问。

该银行允许的最长同意期限,以天为单位。未观测到时为 null。

history_days_max
integer | null
必填

该银行所提供的最长历史数据范围,以天为单位。未观测到时为 null。

pending_transactions
boolean | null
必填

银行是否返回待处理交易。

pending_linkage
boolean | null
必填

银行是否将待处理交易与其已入账交易关联,这会设置 pending_id。

balance_types
enum<string>[]
必填
可用选项:
booked,
available,
expected
transaction_fields
string[]
必填

已知银行会发送的交易字段。其他所有字段均为 null。

sign_in
enum<string> | null
必填

用户在银行的登录方式。

可用选项:
redirect,
app_approval,
credentials,
null
requires_end_user_email
boolean | null
必填

Bank Link 是否需要该用户已验证的邮箱地址。

corporate_accounts
boolean | null
必填

是否支持企业账户。

bank_account_selection
boolean | null
必填

用户是在银行端而非 Bank Link 中选择账户。

银行是否要求再次确认才能释放更早的历史数据。

reconfirmation
boolean | null
必填

续期能否在 Didit 的页面上重新确认,而无需再次登录银行。

sync_frequency_hours
integer | null
必填

在银行允许更高频率时,两次自动同步之间的小时数。null 表示每日默认频率。

health
enum<string>
必填
可用选项:
operational,
degraded,
down
最后修改于 2026年11月22日