> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleariflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 简介

> Cleariflow 银行验证 API 通过现代化的 RESTful JSON 接口提供国际银行账号（IBAN）和业务标识码（BIC）的全面验证——支持 50 多个国家。

## 快速开始

<Card title="IBAN 验证" icon="credit-card" href="bank-validation/iban">
  `iban` 端点验证国际银行账号，提供全面的国家特定验证、格式检查和详细的结构信息，适用于金融应用。
</Card>

<Card title="BIC 验证" icon="building" href="bank-validation/bic">
  `bic` 端点验证业务标识码，提供银行代码、国家信息和机构类型的详细解析，适用于国际银行业务。
</Card>

<Card title="支持的国家" icon="globe" href="bank-validation/countries">
  IBAN 和 BIC 验证支持国家的完整列表，包括国家代码、货币信息和特定格式要求。
</Card>

### 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   | 服务器不可用。                             |