{
"input": "DE89 3704 0044 0532 0130 00",
"iban": "DE89370400440532013000",
"valid": true,
"country_code": "DE",
"country_name": "Allemagne",
"check_digits": "89",
"bban": "370400440532013000",
"expected_length": 22,
"length": 22,
"formatted": "DE89 3704 0044 0532 0130 00",
"errors": [],
"sepa": true
}
curl --location --request GET 'https://zylalabs.com/api/15133/clearcheck+iban+validator+api/40370/valider+un+iban' --header 'Authorization: Bearer YOUR_API_KEY'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 ClearCheck IBAN 验证器 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
验证响应为 JSON,包含标准化后的 IBAN、有效性状态、国家代码和名称、校验位、BBAN、预期长度和实际长度、格式化后的 IBAN、错误详情以及 SEPA 指示符。例如,`valid: true` 表示所有支持的检查均已通过。
该 API 允许输入空格,会对输入进行标准化,验证国家代码,检查该国家特定的长度和 BBAN 结构,并使用 mod-97 算法验证 IBAN 校验位。它不会验证账户是否处于开放状态或能否接收付款】【。
规范化后的 `iban` 值会移除空格,并使用连续的字母数字字符串,例如 `DE89370400440532013000`。`formatted` 值会将字符按每四个一组排列,例如 `DE89 3704 0044 0532 0130 00`。
`country_code` 标识 IBAN 的两字母国家前缀,而 `country_name` 提供其对应的名称。`sepa` 布尔值表示该国家是否属于 API 认可的 SEPA 覆盖范围;这与 IBAN 本身是否有效无关】【。
国家列表接口会返回受支持的 IBAN 国家及其预期长度和结构性 BBAN 格式。这些元数据可用于在提交 IBAN 前验证输入要求,或创建特定国家的表单规则。涵盖 IBAN 注册表中的 78 个国家。
校验位端点接受国家代码和 BBAN,然后使用标准的模 97 方法计算两位数的 IBAN 校验码。该结果可以与国家代码和 BBAN 组合以构造候选 IBAN,随后应对其进行验证
验证结果包含一个 `errors` 数组,允许客户端检查一个或多个检测到的问题,同时在有可用数据时仍能接收规范化后的数据。请求级别的失败使用 `{"error":{"code","message"}}` 形式的 JSON,以便客户端统一处理错误。
不。API 描述说明不会存储任何银行数据。客户端仍应避免不必要地记录原始 IBAN,并应根据自身的安全和隐私要求保护请求和响应数据