您需要快速验证美国路由号码,返回银行名称和联系信息,并将其纳入您的入职、支付或付款操作中。本指南结束时,您将调用一个真实的“路由银行检查器”端点,解析您关心的响应字段,并了解如何从同一金融 API 验证 IBAN 和 SWIFT 代码,使用 Zyla API Hub。
您可以使用此金融 API 构建的内容
SWIFT - IBAN - 路由银行检查器 API 返回三种标识符的银行元数据:
- 美国路由号码:确认有效性并获取银行名称、城市/州、地址、电话和修订日期。
- IBAN 代码:检查有效性并提取银行代码、分行代码、账户号码和国家信息。
- SWIFT/BIC 代码:验证并检索银行名称、位置、地址、国家/国家代码以及结构化细分。
开发人员使用它来加强入职表单,防止支付错误路由,调和供应商数据,并在账户详细信息未通过验证时显示清晰的错误消息。
在 Zyla API Hub 上开始
Zyla API Hub 将超过 10,000 个公共 API 集中在一个帐户下,一个 API 密钥和订阅 + 配额模型(不是按调用付费)。此金融 API 提供 7 天试用或 50 次请求,让您在承诺之前验证集成。要继续:
- 打开 API 页面: 开始 7 天试用 SWIFT - IBAN - 路由银行检查器 API。
- 点击订阅或开始免费试用(如果可用),并复制您的 API 密钥。
- 在请求 Hub 端点时使用 Authorization: Bearer YOUR_API_KEY。
您将调用托管在 zylalabs.com 下的端点。无需单独的来源或访问密钥——您的 Hub 密钥涵盖此 API。
端点概述(金融)
以下是您可以从同一 API 调用的三个端点。所有都是 HTTP GET 请求并返回 JSON。
1) 路由银行检查器
验证美国路由号码并检索银行详细信息。
- 方法:GET
- URL:https://zylalabs.com/api/1887/swift-iban-routing-bank-checker-api/1580/routing-bank-checker
- 必需的查询参数:number
示例必需参数:
- number (number, required): 121000248
可复制的 cURL(官方示例):
curl -s -X GET "https://zylalabs.com/api/1887/swift-iban-routing-bank-checker-api/1580/routing-bank-checker?number=121000248" \
-H "Authorization: Bearer YOUR_API_KEY"
官方 JSON 响应:
{
"status": 200,
"success": true,
"message": "路由银行 031101334 是有效的",
"data": {
"routing_number": "031101334",
"date_of_revision": "2023年1月5日",
"new_routing_number": "",
"bank": "Sofi Bank, National Association",
"address": "旧金山,加州",
"city": "旧金山",
"state": "CA",
"zip": "",
"phone": "855-936-2269"
}
}
您可能会使用的字段亮点:
- status 和 success:请求结果的快速测试。
- message:可读性强的有效性说明(对 UI 提示或日志有用)。
- data.routing_number:已验证的号码(也可以反映规范/更新值)。
- data.bank, data.city, data.state, data.address, data.phone:银行身份和联系信息,用于 KYC、支持或审计。
- data.date_of_revision 和 data.new_routing_number:跟踪更新或重定向(如果存在)。
2) IBAN 代码检查器
验证 IBAN 并接收解析的组件。
- 方法:GET
- URL:https://zylalabs.com/api/1887/swift-iban-routing-bank-checker-api/1581/iban-code-checker
- 必需的查询参数:number
示例必需参数:
- number (string, required): PT50000101231234567890192
此端点返回 IBAN 是否有效及其细分(例如,国家、银行代码、分行代码、账户号码)。将其集成以在支付或合作伙伴入职之前预验证 EU/SEPA 详细信息。
3) SWIFT 代码检查器
验证 SWIFT/BIC 代码并检索银行资料和详细细分。
- 方法:GET
- URL:https://zylalabs.com/api/1887/swift-iban-routing-bank-checker-api/1582/swift-code-checker
- 必需的查询参数:code
示例必需参数:
- code (string, required): ADTVBRDF
使用此功能验证国际转账目的地,并在表单中自动填写银行数据,减少手动错误和支持票据。
Python 示例:验证路由号码并解析字段
此代码片段调用路由银行检查器端点,检查成功并打印银行详细信息。将 YOUR_API_KEY 替换为您从 Zyla API Hub 获取的密钥。
import requests
API_KEY = "YOUR_API_KEY"
URL = "https://zylalabs.com/api/1887/swift-iban-routing-bank-checker-api/1580/routing-bank-checker"
params = {"number": "121000248"}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(URL, params=params, headers=headers, timeout=10)
resp.raise_for_status()
payload = resp.json()
if payload.get("success"):
data = payload.get("data", {})
print("已验证的路由号码:", data.get("routing_number"))
print("银行:", data.get("bank"))
print("位置:", f'{data.get("city")}, {data.get("state")}')
print("地址:", data.get("address"))
print("电话:", data.get("phone"))
print("修订日期:", data.get("date_of_revision"))
new_rn = data.get("new_routing_number")
if new_rn:
print("新路由号码:", new_rn)
else:
print("验证失败:", payload.get("message"))
节省时间的注意事项:
- 需要授权头:Authorization: Bearer YOUR_API_KEY。
- 响应包括状态、成功、消息和数据。使用这些而不是猜测每个失败原因的 HTTP 代码。
- 短期缓存已知的有效验证(例如,几分钟到几小时),以减少高流量流中的重复。
- 如果您存储结果,请保留 date_of_revision 和 new_routing_number 以跟踪潜在更改。
实用集成模式
入职表单中的内联验证
- 在路由号码字段失去焦点时,调用路由银行检查器端点。
- 将银行、城市、州作为只读确认显示给用户。
- 如果无效,显示消息字段以提供清晰反馈。
支付前的预检
- 在安排转账之前验证路由/IBAN/SWIFT。
- 记录您验证的消息和 data.routing_number(或 IBAN/SWIFT)以协助调和。
后台调和
- 使用银行身份字段(银行、城市、州/国家)来丰富供应商记录。
- 如果出现 new_routing_number,请提醒操作人员以便他们可以联系供应商进行更新。
错误处理和可靠性提示
- 传输错误:处理超时和非 2xx 响应,进行重试和退避。
- 应用程序级错误:检查成功和消息;在管理工具中显示消息以提高清晰度。
- 幂等性:读取是安全的重试;避免在每次按键时进行大量请求——防抖表单输入。
- 分页:不适用——每个标识符进行单次检查。
- 时间戳/单位:date_of_revision 是一个人类可读的日期字符串(例如,“2023年1月5日”)。如果需要一致的格式,请解析。
安全和合规基础
- 不要以明文记录完整的账户号码;仅在需要时存储路由/IBAN/SWIFT。
- 将 API 密钥的使用限制为服务器端或安全代理环境。定期轮换密钥。
- 如果您构建面向用户的流程,请在边缘进行速率限制,并明智地缓存正验证。
从 AI 代理调用金融 API(MCP)
如果您使用 Claude Code、Cursor、Windsurf 或任何兼容 MCP 的客户端,可以通过 MCP 端点路由调用。将您的代理指向:
https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY
从那里,指示代理使用与上面显示的相同端点路径调用 SWIFT - IBAN - 路由银行检查器 API 工具。这使您的密钥集中,并允许多个以 AI 为先的开发工具通过 MCP 调用相同的金融 API。有关概述,请参见: MCP。
您将最常使用的端点详细信息
路由银行检查器
- GET https://zylalabs.com/api/1887/swift-iban-routing-bank-checker-api/1580/routing-bank-checker
- 参数:number(必需)
- 用例:美国 ACH/电汇验证、银行自动填充、支持查询。
- 响应字段:routing_number、bank、city、state、address、phone、date_of_revision、new_routing_number。
IBAN 代码检查器
- GET https://zylalabs.com/api/1887/swift-iban-routing-bank-checker-api/1581/iban-code-checker
- 参数:number(必需)
- 用例:SEPA/EEA 支付、欧盟供应商入职。
- 响应字段:iban、country、sepa_country、checksum、bban、bank_code、branch_code、account_number。
SWIFT 代码检查器
- GET https://zylalabs.com/api/1887/swift-iban-routing-bank-checker-api/1582/swift-code-checker
- 参数:code(必需)
- 用例:跨境汇款、受益银行验证。
- 响应字段:swift_code、bank、city、branch、address、post_code、country、country_code、breakdown(包括 bank_code、location_code 等)。
测试策略
- 从提供的示例参数值开始,以确认您的身份验证和解析流程。
- 进行负面案例:尝试格式错误的号码/代码,并验证您是否正确处理消息和成功。
- 监控生产中重复的验证,并添加短期缓存以减少响应时间和配额。
Zyla API Hub 的操作考虑事项
- 计费:订阅 + 配额模型,而不是按调用付费。
- 首次 API 访问:7 天试用或 50 次请求;查看 API 页面以获取当前访问选项和定价。
- 集中身份验证:Hub 上每个 API 仅需一个密钥;通过您的帐户设置进行轮换。
常见问题
Q1:我需要什么头进行身份验证?
A:在每个请求中发送 Authorization: Bearer YOUR_API_KEY 到 Hub 端点。
Q2:我可以从同一集成验证 IBAN 和 SWIFT 吗?
A:可以。此金融 API 暴露三个 GET 端点:路由银行检查器、IBAN 代码检查器和 SWIFT 代码检查器。每个都使用一个必需的查询参数。
Q3:我如何处理路由号码的更改?
A:检查 data.new_routing_number。如果存在,提示用户更新记录并记录更改以及 data.date_of_revision。
Q4:有没有免费计划?
A:没有免费计划。此 API 使用订阅 + 配额模型。首次 API 访问提供 7 天试用或 50 次请求——请查看列表以获取详细信息。
Q5:我可以从 AI 编码代理调用它吗?
A:可以。使用 MCP 端点 https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY 与您的代理。有关概述,请参见这里: MCP。
发布它
使用一个 API 密钥和清晰、结构化的响应验证路由号码、IBAN 和 SWIFT 代码。复制上面的 cURL,放入您的密钥,并将字段插入您的表单和付款检查中。当您准备好时,从这里开始: 开始 7 天试用 SWIFT - IBAN - 路由银行检查器 API。