联行号查询API接口

接口描述

通过银行，省份，城市，关键字等字段检索, 返回对应的联行号，支行全称，地址，电话，成立时间等信息。

报价与开通

查看接口报价，请先登录 / 注册

请求说明

请求地址 https://api.cwjyz.com.cn/bank/cnaps_query
请求方式 POST/GET

基本参数

参数	值
appid	开通后系统自动分配
sign	开通后系统自动分配

请求参数

参数	是否必填	类型	可选值范围	说明
bank	否	string	中国境内银行 (点击查看)	1. 输入 “工商银行” 或 “中国工商银行股份有限公司” 都可以，等效 2. 农村商业银行，农村信用社，农村合作银行等统统填 “农村商业银行”
provi	否	string	省份/直辖市/自治区 (点击查看)	输入 “广西” 或 “广西壮族自治区” 都可以，等效
city	否	string	地级市/自治州/直辖市 (点击查看)	直辖市比如“北京” 地级市比如“保定” 请勿输入县级市
keywords	否	string	任意关键字	银行名称中的关键字
page	否	int	1~10	分页信息, 第几页, 最多10页。每页最多展示10条数据

示例代码

function get_cnaps($provi='',$city='',$bank='',$keywords='',$page=1){
        
        $url='https://api.cwjyz.com.cn/bank/cnaps_query';
  
        $appid = "您自己的AppId";
        
        $sign = "您自己的Sign";

        $post_data = array(

          'appid' => $appid,
          'sign' => $sign,
          'provi'=> $provi,
          'city'=>$city,
          'bank'=>$bank,
          'keywords'=>$keywords,
          'page'=>$page

        );
        
        $data=json_encode($post_data);
  
        $headerArray =array("Content-type:application/json;charset='utf-8'","Accept:application/json");
        
        $curl = curl_init();//初始化CURL句柄 
        curl_setopt($curl, CURLOPT_URL, $url);//设置请求的URL
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($curl, CURLOPT_SSL_VERIFYHOST,FALSE);
        curl_setopt($curl, CURLOPT_POST, 1);//设置请求方式
        curl_setopt($curl, CURLOPT_POSTFIELDS, $data);//设置提交的字符串
        curl_setopt($curl,CURLOPT_HTTPHEADER,$headerArray);
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);//设为TRUE把curl_exec()结果转化为字串
        $output = curl_exec($curl);
        curl_close($curl);

        return json_decode($output,true);//json转数组
}

public static void main(String[] args) {
        String host = "https://api.cwjyz.com.cn";
        String path = "/bank/cnaps_query";
        String method = "GET";
        String appid = "您自己的AppId";
        String sign = "您自己的Sign";
        
        headers.put("Content-Length", "978");
        Map querys = new HashMap();
        querys.put("appid", appid); 
        querys.put("sign", sign);    
        querys.put("bank", "平安银行");
        querys.put("provi", "黑龙江");
        querys.put("city", "哈尔滨");
        querys.put("keywords", "分行");
        querys.put("page", "1");

        try {
            
            HttpResponse response = HttpUtils.doGet(host, path, method, headers, querys);
            System.out.println(response.toString());
            
        } catch (Exception e) {
            e.printStackTrace();
        }
}

import urllib, urllib2, sys
import ssl


host = 'https://api.cwjyz.com.cn'
path = '/bank/cnaps_query'
method = 'GET'
appid = '您自己的Appid'
sign = "您自己的Sign";
querys = 'appid=appid&sign=sign&bank=bank&city=city&keywords=keywords&page=page&provi=province'
bodys = {}
url = host + path + '?' + querys

request = urllib2.Request(url)
request.add_header('Content-Length', '978')
ctx = ssl.create_default_context()
ctx.check_hostname = False
ctx.verify_mode = ssl.CERT_NONE
response = urllib2.urlopen(request, context=ctx)
content = response.read()
if (content):
    print(content)

返回说明

返回格式 JSON

返回字段

字段	是否必备	类型	说明
code	是	int	状态码: - 200 请求成功，返回数据 - 203 请求成功，但page当前页超总页数 - 204 请求成功，查无数据
msg	是	string	提示信息
query_id	是	bigint	唯一的请求编号
remaining	否	int	该API接口剩余可使用次数。注：调用成功且返回数据才扣减次数
result	否	array	数据结果
+ total_items	否	int	符合条件的元素总数
+ page_items	否	int	当前页包含元素个数
+ curr_page	否	int	当前页
+ total_page	否	int	总页数
+ data	否	array[]	符合条件的银行信息
++ bank	否	string	所属银行总行
++ provi	否	string	所在省份
++ city	否	string	所在城市
++ name	否	string	具体银行完整名称
++ cnaps	否	int	联行号
++ status	否	int	状态 0：停业 1：现用名 2：曾用名
++ address	否	string	地址
++ tel	否	string	电话
++ open_date	否	string	成立时期

返回示例

{
    "code": 200,
    "msg": "success",
    "query_id": "651677299310",
    "remaining": 19008,
    "result": {
        "total_items": 1,
        "page_items": 1,
        "curr_page": 1,
        "total_page": 1,
        "data": [
            {
                "bank": "平安银行股份有限公司",
                "provi": "黑龙江省",
                "city": "哈尔滨市",
                "name": "平安银行股份有限公司哈尔滨分行",
                "cnaps": 307261049000,
                "status": "1",
                "address": "黑龙江省哈尔滨市南岗区中山路193号",
                "tel": "0451-51008000",
                "open_date": "2020-10-26"
            }
        ]
    }
}

错误码

代码	说明
401	无效app id
403	签名sign验证错误
405	剩余可使用次数为0
4001	Bank参数错误，无效的银行名称
4002	Provi参数错误，无效的省份名称
4003	City参数错误，无效的城市名称
4004	Page参数错误，page须小于等于10，最多展示10页