跳转到主要内容

快速开始

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 错误响应,包含特定代码和描述,便于有效排查问题。
CodeTypeDetails
200OK一切按预期运行。
400Bad request错误请求——参数缺失或无效。
401Unauthorized请求不可接受。通常由于 API 密钥缺失或不正确。
422Quota reached由于 API 积分不足,请求被中止。(免费计划)
429Too many requests由于达到每秒允许请求数,请求被中止。免费计划的请求限制为每秒 1 次。
500Internal server error由于服务器端错误,无法完成请求。
503Service unavailable服务器不可用。