接入文档
SWIFT/BIC 查询
验证 SWIFT/BIC 格式并查询银行、分行、国家、城市与地址信息。
Endpoint
POST /v1/swift-bic-query
Authentication
Use a ToolKK OpenAPI AppKey. APILayer credentials stay on the ToolKK provider gateway.
Billing
A successful call costs 20 coins.
Errors
Invalid input, quota exhaustion, authentication faults, and temporary provider failures return normalized error codes and messages.
接入示例代码
提供 Shell、Python、Go、Java、PHP 等常见接入示例,便于直接接到现有项目里。
请求示例
{
"swift_code": "COBADEFF574"
}响应示例
{
"code": "SUCCESS",
"message": "success",
"data": {
"valid": true,
"swift": "COBADEFF574",
"bank_name": "COMMERZBANK AG",
"country": "Germany",
"city": "ANDERNACH"
}
}请求字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| swift_code | string | COBADEFF574 |
响应字段
以下字段根据示例 JSON 自动提取,仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| code | string | SUCCESS |
| message | string | success |
| data | object | {...} |
| data.valid | boolean | true |
| data.swift | string | COBADEFF574 |
| data.bank_name | string | COMMERZBANK AG |
| data.country | string | Germany |
| data.city | string |