获取银行信息的API

您需要验证美国的路由号码，并提取银行的法定名称、地址、电话和状态，以便您的财务工作流程能够自信地接受或拒绝ACH详细信息。在本指南结束时，您将能够调用一个生产就绪的端点，该端点返回给定路由号码的权威银行信息，并在一小时内将其集成到您的应用中。

此API为您提供的内容

Zyla API Hub上的路由号码银行查找API返回按美国路由号码键入的银行元数据。它是为像ACH入职、支付设置、支付轨道验证和合规检查这样的财务工作流程而构建的。您可以检索：

• 银行名称、分行类型、地址（街道、城市、州、邮政编码）和电话
• 您查询的ACH路由号码和支付类型上下文
• 活动状态标志和最后更新日期
• 在保存之前验证路由号码是否正确

有两个GET端点可用于按路由号码查找。两者都返回银行身份和联系信息；一个明确包含ACH/支付上下文和“活动”标志，另一个强调验证消息。

在Zyla API Hub上开始

打开API的列表，订阅并获取您的密钥：

1. 转到路由号码银行查找API页面并点击订阅或开始免费试用。
2. 从仪表板复制您的API密钥。
3. 使用Authorization: Bearer YOUR_API_KEY调用端点。

Hub使用订阅+配额（而不是按调用付费）。从项目页面可以获得7天的试用；请查看API页面以获取当前访问选项和定价。Zyla托管超过10,000个公共API，因此您可以在不创建新帐户或处理多个密钥的情况下添加其他财务和支付集成。

在路由号码银行查找API上开始7天试用

您今天可以使用的端点

1) 获取银行信息

方法：GET

URL：https://zylalabs.com/api/331/routing-number-bank-lookup-api/266/get-bank-information

它的作用：返回有关路由号码的详细银行信息，包括机构名称、ACH路由号码、分行类型、地址、联系信息、路由是否活动以及最后更新的时间。

所需的查询参数：

• routingnumber（数字）：例如，121000245
• paymentType（字符串）：例如，ach

复制粘贴cURL：

curl -s -X GET "https://zylalabs.com/api/331/routing-number-bank-lookup-api/266/get-bank-information?routingnumber=121000245&paymentType=ach" \
-H "Authorization: Bearer YOUR_API_KEY"

官方示例响应：

{
"status": "success",
"data": {
"routingNumber": "121000245",
"paymentType": "ach",
"name": "Wells Fargo Bank, Na",
"addressFull": "255 2nd Ave South, Minneapolis, MN 55479",
"street": "255 2nd Ave South",
"city": "Minneapolis",
"state": "MN",
"zip": "55479",
"type": "Main Office",
"phone": "800-245-2426",
"active": true,
"lastUpdated": "2026-07-29"
}
}

您通常会使用：

• data.name, data.type, data.addressFull（或street/city/state/zip）
• data.phone用于客户或后台验证
• data.active用于拒绝不活动/退休的路由号码
• data.lastUpdated用于通知缓存TTL和审计日志

2) 银行数据

方法：GET

URL：https://zylalabs.com/api/331/routing-number-bank-lookup-api/1353/bank-data

它的作用：验证路由号码并返回银行详细信息，例如名称、地址、城市、州、邮政编码和电话。

所需的查询参数：

• number（数字）：例如，304082876

复制粘贴cURL：

示例响应：

您通常会使用：

• message以确认有效性，然后再保存到您的数据库
• data.bank, data.address, data.city, data.state, data.zip
• data.phone用于验证或支持流程

节省时间的生产笔记

• 身份验证：在每个请求中发送Authorization: Bearer YOUR_API_KEY。
• 幂等性：两个端点都是GET，安全可重试。
• 缓存：银行元数据变化不频繁。考虑按路由号码进行缓存；对于获取银行信息端点，您可以根据data.lastUpdated调整TTL。如果您缓存，还要存储使用的paymentType。
• 输入验证：仅接受九位数字的美国路由号码。在获取银行信息端点中，当您需要ACH上下文结果时，准确包含paymentType=ach。
• 错误处理：围绕状态字段和嵌套数据的存在/缺失进行防御性编程。记录并显示您尝试的确切路由号码以便审计。
• 配额和定价：Hub使用订阅+配额。可以从列表中获得7天的试用。请查看API页面以获取当前访问选项和定价。

快速启动代码：Python

此示例调用获取银行信息，检查活动标志，并规范化地址以进行显示或存储。

import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://zylalabs.com/api/331/routing-number-bank-lookup-api/266/get-bank-information"

params = {
"routingnumber": "121000245",
"paymentType": "ach"
}

headers = {
"Authorization": f"Bearer {API_KEY}"
}

resp = requests.get(BASE_URL, headers=headers, params=params, timeout=15)
resp.raise_for_status()
payload = resp.json()

if payload.get("status") != "success" or "data" not in payload:
raise RuntimeError(f"查找失败：{payload}")

data = payload["data"]

bank_record = {
"routing_number": data.get("routingNumber"),
"payment_type": data.get("paymentType"),
"name": data.get("name"),
"address": {
"street": data.get("street"),
"city": data.get("city"),
"state": data.get("state"),
"zip": data.get("zip"),
"full": data.get("addressFull"),
},
"phone": data.get("phone"),
"active": data.get("active"),
"last_updated": data.get("lastUpdated"),
}

if not bank_record["active"]:
print("路由处于非活动状态；阻止ACH设置。")
else:
print(f"可以继续与{bank_record["name"]}在{bank_record["address"]["full"]}进行交易")

何时使用每个端点

• 当您需要ACH上下文、明确的活动状态和最后更新日期以驱动缓存或审计时，请使用获取银行信息。
• 当您只想要简洁的有效性消息和核心身份字段以进行显示或快速验证时，请使用银行数据。

常见财务工作流程

• 客户入职（ACH）：在保存之前验证路由号码。如果data.active为false，则阻止提交并提示进行更正。
• 支付设置：存储data.name和data.phone与路由号码，以便支持团队可以排查退回问题。
• 供应商管理：使用响应中的addressFull/street/city/state/zip规范化文件中的地址。
• 欺诈/合规检查：将用户提供的银行名称与data.name进行比较，并记录不匹配以供审核。
• 支付重试：如果借记因无效路由而返回，请使用银行数据重新验证，并向用户显示消息上下文。

通过MCP从AI代理调用API

如果您使用的是与MCP兼容的客户端（例如，Claude Code、Cursor、Windsurf），您可以通过Zyla MCP端点将路由号码银行查找API暴露给您的代理。然后，代理可以使用您的API密钥执行与您在上面看到的相同的GET调用，从而在代码生成或操作聊天期间简化查找。请在此处查看MCP文档：MCP。MCP端点接受您的API密钥，并允许代理调用Hub列出的端点；当工具发出HTTP请求时，请使用相同的Authorization: Bearer YOUR_API_KEY头语义。

端到端测试清单

• 快乐路径：已知的良好路由号码返回状态：“success”（获取银行信息）或success：true（银行数据）和预期的银行字段。
• 非活动路径：如果data.active为false，请确保您的UI阻止ACH配置并记录事件。
• 验证错误：在发送请求之前，针对非9位数字输入提供清晰的消息。
• 超时：设置合理的HTTP客户端超时（例如，10-20秒），并重试一次幂等的GET。
• 缓存：按路由号码缓存；如果lastUpdated早于您的策略阈值，请考虑进行后台刷新。

故障排除笔记

• 401/403错误：确认Authorization头存在且您的订阅处于活动状态。
• 意外结构：记录给定路由号码的完整JSON。围绕可选字段进行防御性解析。
• 与用户输入不匹配：比较修剪过的、转为大写的字段；用户通常输入口语化的银行名称。

常见问题解答

问：身份验证需要哪个头？
答：在每个请求中发送Authorization: Bearer YOUR_API_KEY。

问：我需要两个端点吗？
答：不一定。如果您需要ACH上下文和活动标志，请使用获取银行信息。如果您主要需要有效性消息和核心身份，银行数据就足够了。

问：银行数据多久更改一次，我应该缓存吗？
答：银行主数据变化不频繁。获取银行信息端点返回lastUpdated；使用它来通知您的缓存TTL和审计逻辑。

问：是否有免费计划？
答：没有免费计划。从项目页面可以获得7天的试用；请查看API页面以获取当前访问选项和定价。

问：我可以从AI编码工具调用这个吗？
答：可以。使用Zyla的MCP端点和您的API密钥，以便与MCP兼容的代理可以将这些GET端点作为您工作流程的一部分调用。请参见上面的MCP链接。

准备在您的财务流程中实现路由号码验证和银行元数据吗？在此处订阅并获取您的密钥：在路由号码银行查找API上开始7天试用。您将在几分钟内调用生产端点，并在本周内交付您的集成。