基本信息
接口名称:
银行卡信息查询
请求方法:
GET
计费类型:
免费
接口文档
# 银行卡信息查询 API 文档
可根据银行卡卡号,获取对应的银行信息。获取的银行信息包括银行名称、卡片类型(是信用卡还是借记卡)
---
## 接口说明
- **功能**:根据银行卡号前 6-19 位识别发卡行、卡种(借记/贷记/准贷记/预付费)
- **优势**:零外网依赖、毫秒级、已实测主流/地方/外资银行
---
## 请求地址
```
https://api.logoi.cn/api/bankcard
```
---
## 请求方法
```
GET
```
---
## 请求参数
| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| cardNo | string | 是 | 15-19 位银行卡号(可含空格,自动去除) |
---
## 响应参数
| 字段名 | 类型 | 说明 |
|--------|------|------|
| bankName | string | 发卡行中文名称 |
| bankCode | string | 银行缩写代码(如 ICBC) |
| cardType | string | 卡种编码:DC=借记 CC=贷记 SCC=准贷记 PC=预付费 |
| cardTypeName | string | 卡种中文名 |
---
## 响应示例
### ① 命中
```json
{
"code": 200,
"message": "success",
"data": {
"bankName": "中国工商银行",
"bankCode": "ICBC",
"cardType": "DC",
"cardTypeName": "借记卡"
},
}
```
### ② 未命中
```json
{
"code": 200,
"message": "success",
"data": {
"bankName": "未知银行",
"bankCode": "UNKNOWN",
"cardType": "UNKNOWN",
"cardTypeName": "未知卡种"
},
}
```
---
## 调用示例
### 1. 前端(一行 JS)
```javascript
fetch('https://api.logoi.cn/api/bankcard?cardNo=6222005865412565805')
.then(r => r.json())
.then(d => {
const {bankName, cardTypeName} = d.data;
console.log(`${bankName} · ${cardTypeName}`);
});
```
### 2. 后端(一行 PHP)
```php
$json = file_get_contents('https://api.logoi.cn/api/bankcard?cardNo=6222005865412565805');
$data = json_decode($json, true)['data'] ?? [];
echo $data['bankName'] . ' · ' . $data['cardTypeName'];
```
---
## 卡种对照
| 编码 | 中文名 |
|------|--------|
| DC | 借记卡 |
| CC | 贷记卡 |
| SCC | 准贷记卡 |
| PC | 预付费卡 |
| UNKNOWN | 未知卡种 |
请求参数
| 参数名 | 是否必填 | 类型 | 参数说明 | 示例值 |
|---|---|---|---|---|
| cardNo | 是 | string | 15-19 位银行卡号(可含空格,自动去除) |
请求示例
{
"cardNo": ""
}
返回参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | string | 状态码 |
返回示例
{
"code": "200"
}