首页›API 云市场›银行联行号查询

银行联行号查询

接口编号 BANK01 · 开放平台开发文档

银行联行号查询
接口编号BANK01分类API实用工具 / 银行卡核验状态启用

1、接口说明

银行联行号查询。返回全国各银行分支行(支行/分理处/营业部)的联行号(大额支付行号),含所属银行名称、支行名称、联行号、省份ID、省份、城市ID、城市。数据本地自持(15 万+ 条),支持按银行名/支行名/联行号模糊检索,每次返回 10 条,可按页码翻页。

2、接口信息

请求地址https://leikuang.muzhiyun.com/api/bankcardbase.do
请求方式POST
请求格式application/json; charset=utf-8
响应格式application/json; charset=utf-8
超时时间60 秒(建议)
计费方式按调用次数
计费单位:次;标准售价:0.0003 元 / 次。每次调用成功后从账户余额扣除对应费用,余额不足时接口返回 ok=0 并提示充值。

3、鉴权说明

所有请求必须携带下列三个公共参数,缺一不可。它们既是请求参数,也参与签名。
参数名说明类型必填示例备注
appid应用IDString(32)是muzhiyun由服务商提供;亦支持系统名下权利人的用户编号,即本系统的登陆账户。如果传入,APPKEY应当是账户登陆密码的16位小写md5字符串
sendtime请求时间戳Int是1790784000Unix 时间戳(秒);与服务器时间相差过大视为过期请求
sign签名String(32)是FC265408A1BE19712C7AD03881975D5F签名值:参与签名的参数按变量名升序拼接后加密,不含本字段
签名算法
1) 取本次请求的全部参数(不含 sign 自身);
2) 按参数名 ASCII 升序排序,拼接成 k1=v1&k2=v2&…;
3) 末尾追加 &key=你的AppKey;
4) 对整串做 MD5 后转大写,即得 sign。
调用示例 · 按本接口真实示例值实算一遍
你的 AppKey(仅本地签名用,不随请求发送):YOUR_APP_KEY
1
参与签名的参数(已剔除 sign 自身,按参数名升序)
appid=muzhiyun&keys=厦门 工商&pages=1&sendtime=1792521167
2
末尾追加 &key=你的AppKey
appid=muzhiyun&keys=厦门 工商&pages=1&sendtime=1792521167&key=YOUR_APP_KEY
3
整串做 MD5 后转大写,得到 sign
E59505C832E38DD095B54339C001108A
4
最终请求参数(JSON 包,作为请求 Body 发送)
{
    "appid": "muzhiyun",
    "keys": "厦门 工商",
    "pages": "1",
    "sendtime": "1792521167",
    "sign": "E59505C832E38DD095B54339C001108A"
}
上例 AppKey 写作 YOUR_APP_KEY,请换成你自己的 AppKey 重算 sign —— sign 与 AppKey 绑定,同样的参数换 AppKey 会得到完全不同的 sign。复制本例后,把 YOUR_APP_KEY 替换为你自己的 AppKey,再按 ①②③ 重算 sign 即可直接调用(sendtime 为当前时间戳,300 秒内有效)。排序只按参数名,不看参数值;布尔值按 1/0 参与拼接;数组型参数不参与签名。
时间戳要求:sendtime 为 10 位 Unix 秒级时间戳,与服务器时间相差超过 300 秒 视为过期请求。AppID / AppKey 由开放平台发放,可在「用户管理 → 开发者凭证」中查看。

4、请求参数

以下参数通过 Body(application/json) 传递
参数名说明类型必填示例备注
pages页码Int否1页码,从 1 开始;每页固定 10 条,最多 2000 页
keys检索关键词String(50)否厦门 工商银行名称 / 支行名称 / 联行号 任一字段模糊匹配;按空格拆词,多词之间为 AND;留空则返回全量

5、返回结果

接口统一返回 JSON,ok=1 表示成功、ok=0 表示失败;鉴权或配置类错误同时返回 HTTP 666。
字段类型说明
okInt1=成功,0=失败
msgString结果描述 / 失败原因
成功响应示例
{
    "ok": 1,
    "msg": "查询成功,共3条记录,每页10条,当前第1\/1页",
    "keys": "厦门 工商",
    "pages": 1,
    "thispage": 1,
    "pagecount": 1,
    "count": 3,
    "list": [
        {
            "bankname": "中国工商银行",
            "name": "中国工商银行股份有限公司厦门嘉禾支行",
            "code": "102393000077",
            "provinceid": "130000",
            "province": "福建",
            "cityid": "130200",
            "city": "厦门市"
        },
        {
            "bankname": "中国工商银行",
            "name": "中国工商银行股份有限公司厦门杏林湾支行",
            "code": "102393000181",
            "provinceid": "130000",
            "province": "福建",
            "cityid": "130200",
            "city": "厦门市"
        },
        {
            "bankname": "中国工商银行",
            "name": "中国工商银行股份有限公司厦门金融中心支行",
            "code": "102393000253",
            "provinceid": "130000",
            "province": "福建",
            "cityid": "130200",
            "city": "厦门市"
        }
    ]
}
失败响应示例
{
    "ok": 0,
    "msg": "页码pages必须为正整数"
}
余额不足 / 无可用套餐
{
    "ok": 0,
    "msg": "余额不足,且无可用套餐,请充值后重试。"
}
接口已停用
{
    "ok": 0,
    "msg": "接口【银行联行号查询】已停用,暂停调用,请联系管理员。"
}
常见错误提示(msg 原文)
缺少必要的参数【appid、sendtime、sign】请详看开发文档。
AppID不存在,请联系产品经理进行业务开通。
sendtime不是10位的数字。
时间戳超时,请重新请求。
签名校验失败。
余额不足,请充值后重试。
接口【XXX】已停用,暂停调用,请联系管理员。

6、调用示例

下面示例自动计算签名(ksort 后 MD5 大写):复制后只需把 你的AppID / 你的AppKey 换成真实凭证即可运行。Python / PHP 为完整可运行版;cURL、JavaScript 展示请求形态。GET 接口请把参数(含 appid/sendtime/sign)拼到 URL 查询串。
cURL
curl -X POST "https://leikuang.muzhiyun.com/api/bankcardbase.do" \
  -H "Content-Type: application/json" \
  -d &#039;{"appid":"你的AppID", "sendtime":"<当前时间戳>", "sign":"<按签名算法计算>", "appid":"muzhiyun","sendtime":"1790784000","pages":"1","keys":"厦门 工商" }'
PHP
<?php
$appId  = "你的AppID";      // 没有则填 muzhiyun
$appKey = "你的AppKey";
$url    = "https://leikuang.muzhiyun.com/api/bankcardbase.do";

$params = [
    &#039;appid' => 'muzhiyun',
    &#039;sendtime' => '1790784000',
    &#039;pages' => '1',
    &#039;keys' => '厦门 工商',
];
// 以下三项由代码自动补,无需手填
$params["appid"]    = $appId;
$params["sendtime"] = (string)time();
ksort($params);
$src = &#039;';
foreach($params as $k=>$v) $src .= $k.&#039;='.$v.'&';
$src .= &#039;key='.$appKey;
$params["sign"] = strtoupper(md5($src));

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL            => $url,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [&#039;Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode($params, JSON_UNESCAPED_UNICODE),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);

$resp = curl_exec($ch);
curl_close($ch);
echo $resp;
Python
import time, hashlib, json, urllib.request

APP_ID  = "你的AppID"      # 没有则填 muzhiyun
APP_KEY = "你的AppKey"
URL     = "https://leikuang.muzhiyun.com/api/bankcardbase.do"

params = {
    "appid": "muzhiyun",
    "sendtime": "1790784000",
    "pages": "1",
    "keys": "厦门 工商",
}
params["appid"]    = APP_ID
params["sendtime"] = str(int(time.time()))
params = dict(sorted(params.items()))  # 参数名升序
sign_src = "&".join(f"{k}={v}" for k, v in params.items()) + "&key=" + APP_KEY
params["sign"] = hashlib.md5(sign_src.encode("utf-8")).hexdigest().upper()

req = urllib.request.Request(
    URL,
    data=json.dumps(params).encode("utf-8"),
    headers={"Content-Type": "application/json"},
    method="POST",
)
print(urllib.request.urlopen(req, timeout=30).read().decode("utf-8"))
JavaScript
const url = "https://leikuang.muzhiyun.com/api/bankcardbase.do";
const params = {
  &#039;appid': 'muzhiyun',
  &#039;sendtime': '1790784000',
  &#039;pages': '1',
  &#039;keys': '厦门 工商',
  appid: "你的AppID",
  sendtime: String(Math.floor(Date.now()/1000)),
  // sign: 按上文「签名算法」在前端算 md5(ksort(k=v&…)&key=AppKey) 后填入
};
fetch(url, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify(params),
}).then(r => r.json()).then(console.log);

7、注意事项

1、参数 keys:检索关键词,可空(不传或空串=全量按 id 顺序返回)。按空格拆成多个词,各词之间为 AND;每个词在【银行名称 / 支行名称 / 联行号】任一字段上模糊命中即算匹配。例:keys=厦门 工商 → 厦门的工商银行分支行;keys=102393 → 联行号含 102393 的分支行。
2、参数 pages:页码,从 1 开始,每页固定返回 10 条。默认 1。页码上限 2000 页,超出返回 ok=0,请缩小关键词范围。
3、返回 count 为符合条件总条数、pagecount 为总页数。count > 10 时开发者可递增 pages 继续调用;当返回 list 为空数组即已翻到末尾。
4、返回 ok=1 表示查询成功(count 为 0 也是成功,只是查无结果,list 为空数组);ok=0 仅表示参数或服务层错误。
5、本接口为免费接口,按次调用不计费(余额不足不会拦截)。
6、省份/城市名称与本站「地址行政区划字典查询」(BQ08 / area.json)口径一致;省份ID、城市ID 沿用源表自带行政区划码。
7、鉴权三项(appid / sendtime / sign)为所有开放接口通用必填,签名算法见下方「请求参数」说明。
AI 客服
拇指云 AI 客服
在线 · 工作日 9:00-18:00
智能客服在线,回复由 AI 自动生成