快速开始
IBAN 验证
iban 端点验证国际银行账号,提供全面的国家特定验证、格式检查和详细的结构信息,适用于金融应用。BIC 验证
bic 端点验证业务标识码,提供银行代码、国家信息和机构类型的详细解析,适用于国际银行业务。支持的国家
IBAN 和 BIC 验证支持国家的完整列表,包括国家代码、货币信息和特定格式要求。
REST 架构
银行验证 API 遵循 REST 原则,采用可预测的资源导向 URL 和标准 HTTP 状态码,实现无缝集成和错误处理。HTTPS 安全
所有 API 通信均使用 TLS 1.2 或更高版本的加密协议进行保护,确保数据完整性和隐私。API 版本控制
银行验证 API 通过版本控制保持向后兼容,当前运行在第 1 版,并计划未来增强。身份验证
API 密钥是访问银行验证 API 的唯一凭证。每个 Cleariflow 服务需要唯一的密钥,确保不同 API 之间的安全隔离访问。响应和错误代码
请求失败时,API 返回结构化的 JSON 错误响应,包含特定代码和描述,便于有效排查问题。| Code | Type | Details |
|---|---|---|
| 200 | OK | 一切按预期运行。 |
| 400 | Bad request | 错误请求——参数缺失或无效。 |
| 401 | Unauthorized | 请求不可接受。通常由于 API 密钥缺失或不正确。 |
| 422 | Quota reached | 由于 API 积分不足,请求被中止。(免费计划) |
| 429 | Too many requests | 由于达到每秒允许请求数,请求被中止。免费计划的请求限制为每秒 1 次。 |
| 500 | Internal server error | 由于服务器端错误,无法完成请求。 |
| 503 | Service unavailable | 服务器不可用。 |