curl
curl 'https://verification.didit.me/v3/bank/institutions/es-banco-norte/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.bank.get_institution(
"your-id",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.bank.getInstitution("your-id");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Bank.GetInstitution(ctx, "your-id")
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.bank().getInstitution("your-id");
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->bank->getInstitution('your-id');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.bank.get_institution("your-id")
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Bank.GetInstitutionAsync("your-id");
Console.WriteLine(JsonSerializer.Serialize(result));{
"id": "es-banco-norte",
"name": "Banco Norte",
"country": "ESP",
"logo_url": "https://static.example.com/banks/es-banco-norte.png",
"timezone": "Europe/Madrid",
"segments": [
"personal",
"business"
],
"access": [
"one_time",
"ongoing"
],
"ongoing_access": true,
"consent_days_max": 180,
"history_days_max": 365,
"pending_transactions": true,
"pending_linkage": false,
"balance_types": [
"booked",
"available"
],
"transaction_fields": [
"value_date",
"counterparty_name",
"counterparty_iban",
"remittance",
"bank_transaction_code",
"bank_reference",
"balance_after"
],
"sign_in": "redirect",
"requires_end_user_email": true,
"corporate_accounts": true,
"bank_account_selection": false,
"separate_history_consent": false,
"reconfirmation": false,
"sync_frequency_hours": null,
"health": "operational"
}
银行与覆盖范围
获取银行 API:单个机构及其能力
Didit 的获取机构接口可返回单个银行及其能力与健康状态。
GET
/
v3
/
bank
/
institutions
/
{id}
/
curl
curl 'https://verification.didit.me/v3/bank/institutions/es-banco-norte/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.bank.get_institution(
"your-id",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.bank.getInstitution("your-id");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Bank.GetInstitution(ctx, "your-id")
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.bank().getInstitution("your-id");
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->bank->getInstitution('your-id');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.bank.get_institution("your-id")
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Bank.GetInstitutionAsync("your-id");
Console.WriteLine(JsonSerializer.Serialize(result));{
"id": "es-banco-norte",
"name": "Banco Norte",
"country": "ESP",
"logo_url": "https://static.example.com/banks/es-banco-norte.png",
"timezone": "Europe/Madrid",
"segments": [
"personal",
"business"
],
"access": [
"one_time",
"ongoing"
],
"ongoing_access": true,
"consent_days_max": 180,
"history_days_max": 365,
"pending_transactions": true,
"pending_linkage": false,
"balance_types": [
"booked",
"available"
],
"transaction_fields": [
"value_date",
"counterparty_name",
"counterparty_iban",
"remittance",
"bank_transaction_code",
"bank_reference",
"balance_after"
],
"sign_in": "redirect",
"requires_end_user_email": true,
"corporate_accounts": true,
"bank_account_selection": false,
"separate_history_consent": false,
"reconfirmation": false,
"sync_frequency_hours": null,
"health": "operational"
}
Didit 的 Get an Institution endpoint 会返回一家银行的信息,包括其能力和健康状况。从未观测到的值为
null,而不是猜测的值。授权
您的应用 API 密钥,可在 Business Console 的开发者 -> API 密钥中获取。主密钥拥有完全访问权限。命名密钥可以设置范围:可按资源设置无权限、只读或读写,可限定为部分工作流或已批准的会话,可限定为一组 IP 地址,并可设置过期日期。401 表示密钥错误、已被撤销或已过期;403 表示未发送密钥、密钥无权访问该资源或执行该操作,或请求来自其 IP 列表之外的地址;会话相关路由返回 404,表示该会话不在密钥的工作流或状态范围内。没有媒体访问权限的密钥会将图片、视频和 PDF 的 URL 返回为 null;没有会话写入权限的密钥会将会话链接和令牌返回为 null。请参阅 https://docs.didit.me/console/api-keys。
响应
银行。
银行及其支持的功能。取值来自已观察到的能力数据,每日刷新;从未观察到的值为 null,而不是猜测值。
最后修改于 2026年11月22日