您有一个来自表单、网络钩子或 CSV 的 SWIFT/BIC 代码,您需要在发送付款或存储之前以编程方式验证它。在本文结束时,您将能够验证 SWIFT 代码并使用单个 HTTP GET 从生产端点获取其解析组件,您可以在本周内交付。
此 API 的功能及使用时机
SWIFT 代码查找 API 验证给定的 SWIFT (BIC) 代码并返回有关它的结构化数据。团队使用它来控制银行转账流程、清理财务数据集,并为入职或付款添加服务器端验证。您传递一个 SWIFT 代码;API 会返回一个状态、一个人类可读的消息和一个包含代码及其细分的结构化对象。
由于这是 Zyla API Hub 上的一个 API,您将获得一个帐户、一个 API 密钥,以及跨市场的订阅和配额模型。如果您已经在使用其他 Zyla API 进行财务或验证,您可以将此检查添加到您的堆栈中,而无需管理另一个凭据。
浏览更广泛的目录,访问 zylalabs.com——在一致的开发者体验下,有超过 10,000 个公共 API 可用。
在 Zyla API Hub 上入门
要快速集成:
- 在 Zyla API Hub 上打开 SWIFT 代码查找 API 列表并点击订阅。您添加的第一个 API 可以从 7 天试用或 50 次请求开始,具体取决于可用性。没有免费计划;使用是订阅 + 配额,而不是按调用付费——请查看 API 页面以获取当前访问选项和定价。
- 从您的帐户中复制您的 API 密钥。身份验证通过头部进行:Authorization: Bearer YOUR_API_KEY。
- 从您的服务器或选择的工具调用下面的端点。
您可以随时返回 zylalabs.com 来管理跨 API 的订阅、配额和密钥。
您将实际使用的端点
SWIFT 代码查找 API 暴露一个单一的查找端点,您可以直接通过 HTTP GET 调用。当您手中有一个 SWIFT/BIC 代码并希望获得验证结果和解析细分时,请使用此端点。
代码查找
- 方法:GET
- URL: https://zylalabs.com/api/1714/swift-code-lookup-api/1327/code-lookup
- 必需的查询参数:
- code (string):您想要验证的 SWIFT/BIC。示例值:ADTVBRDF
- 身份验证:Authorization: Bearer YOUR_API_KEY
复制粘贴 cURL
这是从您的终端测试实时服务的最快方法。将 YOUR_API_KEY 替换为您的密钥:
curl -s -X GET "https://zylalabs.com/api/1714/swift-code-lookup-api/1327/code-lookup?code=ADTVBRDF"
-H "Authorization: Bearer YOUR_API_KEY"
官方示例响应
API 返回一个 JSON 文档,其中包含顶级状态和成功指示器、消息和包含代码及其细分的数据对象。以下是官方示例有效负载:
{
"status": 200,
"success": true,
"message": "SWIFT 代码 AXISINBB301 是有效的",
"data": {
"swift_code": "AXISINBB301",
"bank": null,
"city": null,
"branch": null,
"address": null,
"post_code": null,
"country": null,
"country_code": null,
"breakdown": {
"swift_code": "AXISINBB301",
"bank_code": null,
"country_code": null,
"location_code": null,
"code_status": null,
"branch_code": null
}
}
}
实践中要阅读的内容:
- 状态和成功:使用这些来控制您的流程。200 和 success: true 意味着查找成功。
- 消息:您可以为操作员记录的可读验证消息,或在管理工具中显示。
- data.swift_code:已验证的标准化 SWIFT/BIC。
- data.breakdown:将代码结构化拆分为组件。单个字段在不可用时可能为 null。
您可以粘贴到服务中的 Python 示例
下面的代码片段调用相同的端点,并展示如何安全地处理响应字段和 null。URL 和参数值与上面的官方 cURL 匹配,因此您可以在不编辑任何内容的情况下运行此代码,除了您的 API 密钥。
import os
import requests
API_KEY = os.environ.get("ZYLALABS_API_KEY", "YOUR_API_KEY")
URL = "https://zylalabs.com/api/1714/swift-code-lookup-api/1327/code-lookup"
params = {"code": "ADTVBRDF"}
headers = {"Authorization": f"Bearer {API_KEY}"}
resp = requests.get(URL, params=params, headers=headers, timeout=10)
resp.raise_for_status()
data = resp.json()
# 基本控制
if not data.get("success"):
raise SystemExit(f"查找失败:{data.get('message')}")
print(f"消息:{data.get('message')}")
payload = data.get("data", {}) or {}
swift = payload.get("swift_code")
bank = payload.get("bank") # 可能为 None
country = payload.get("country") # 可能为 None
breakdown = (payload.get("breakdown") or {})
bank_code = breakdown.get("bank_code") # 可能为 None
country_code = breakdown.get("country_code") # 可能为 None
branch_code = breakdown.get("branch_code") # 可能为 None
print("验证的 SWIFT 代码:", swift)
print("银行(如果可用):", bank)
print("国家(如果可用):", country)
print("细分:", {
"bank_code": bank_code,
"country_code": country_code,
"branch_code": branch_code
})
如何将其接入实际流程
大多数团队从付款创建或受益人入职端点服务器端调用此 API。一个常见的模式:
- 用户提交银行详细信息,包括 SWIFT/BIC 代码。
- 您的后端通过调用代码查找端点来验证 SWIFT 代码,然后再保存或使用它。
- 如果成功为 true,则继续;如果为 false 或状态不是 200,则拒绝输入并记录消息以供审核。
其他实际用途:
- 批量清理:遍历 CSV 中的 SWIFT 代码,仅存储通过验证的行。
- 对账工具:自动标记具有意外细分值的条目以进行手动 QA。
- 管理仪表板:在用户提交的 SWIFT 代码旁边显示消息和细分。
节省时间的实现细节
- 身份验证:每个请求必须包含 Authorization: Bearer YOUR_API_KEY。
- HTTP 方法:仅 GET。将代码作为查询参数包含。
- Null:字段如银行、国家和单个细分部分可能为 null。在使用之前始终进行 null 检查。
- 缓存:如果您重复验证相同的 SWIFT 代码,请在您的数据存储中缓存结果,以减少延迟和配额使用。简单的内存 TTL 缓存或按 SWIFT 代码键入的行通常就足够了。
- 可观察性:在拒绝输入时记录消息字段,以便在支持升级中更快地进行调试。
- 安全性:请勿记录用户 API 密钥。将您的 Zyla API 密钥存储在环境变量或秘密管理器中。
- 配额:Zyla API 的使用是订阅 + 配额。第一个 API 可以从 7 天试用或 50 次请求开始。有关当前限制,请查看您帐户中的 API 页面。
错误处理模式
虽然上面的示例显示了成功的查找,但生产代码应防范:
- 非 200 HTTP 响应:根据上下文将其视为瞬态故障或用户输入错误。
- 成功为 false:读取消息以获取简短的人类解释,并决定是重试还是拒绝。
- 网络超时:设置合理的客户端超时,并在操作是幂等的情况下用重试包装调用。
通过 MCP 从 AI 代理使用 API
如果您希望将此查找接入 AI 编码代理或 IDE 助手,Zyla 通过 MCP 提供兼容工具。将您的 MCP 兼容客户端(例如 Claude Code、Cursor、Windsurf)指向此处记录的端点,并使用您的 API 密钥进行授权。有关详细信息,请参见 MCP 文档:
这使您可以在代理工作流中触发相同的代码查找,而无需更改后端。您的代理将发送相同的 GET 请求并读取相同的字段(状态、成功、消息、data.swift_code、data.breakdown)。在测试代理集成时,请将您的 API 密钥限制在开发环境中。
端到端验证检查清单
- 在 Zyla API Hub 上激活订阅,并安全存储 API 密钥。
- 服务器端 GET 调用代码查找端点,代码设置为用户提供的 SWIFT/BIC。
- 在进行付款或保存受益人之前检查成功和状态。
- 在您的 UI 或数据层中优雅地处理 null 字段。
- 在适当的情况下按 SWIFT 代码缓存查找结果。
- 记录操作和支持的消息。
在哪里获取您的密钥并运行您的第一个请求
订阅 API,开始 7 天试用(如可用),并复制您的密钥。您可以立即使用上面的 cURL 调用端点,然后将 Python 示例放入您的服务中。管理您的使用情况,并从同一帐户添加其他 API,涵盖财务、数据增强和实用工具,访问 zylalabs.com。
常见问题
代码参数支持哪些输入格式?
通过 GET 请求中的代码查询参数以普通字符串传递 SWIFT/BIC 代码。
我应该依赖哪些字段来判断 SWIFT 代码是否有效?
检查成功和状态。还要读取消息以获取适合日志或管理 UI 的简洁解释。
为什么数据或细分中的某些字段为 null?
并非所有元数据都适用于每个代码。在使用之前始终对银行、国家和细分部分等字段进行 null 检查。
我可以在集成之前从终端测试吗?
可以。使用提供的 cURL 命令和您的 API 密钥快速验证端点和身份验证头。
计费是如何处理的?
Zyla API 使用订阅 + 配额模型,而不是按调用付费。第一个 API 可以从 7 天试用或 50 次请求开始,具体取决于可用性——请查看您帐户中的 API 列表以获取当前选项。