联行号查询API接口

接口描述

通过关键词模糊搜索, 返回对应的联行号等信息。
它与标准查询的区别: 可以智能解析，自动匹配。支持缩写（如工行、招行...），兼容名称不规范（如深圳招行与招行深圳等效）

报价与开通

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

请求说明

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

基本参数

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

请求参数

参数	是否必填	类型	可选值范围	说明
keywords	是	string	银行名称中的关键词	如：招行深圳前海。注意：不少于5位汉字
page	否	int	1~10	分页信息, 第几页, 最多10页。每页最多展示10条数据

示例代码

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

        $post_data = array(

          'appid' => $appid,
          'sign' => $sign,
          '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_ai";
        String method = "GET";
        String appid = "您自己的AppId";
        String sign = "您自己的Sign";
        
        headers.put("Content-Length", "348");
        Map querys = new HashMap();
        querys.put("appid", appid); 
        querys.put("sign", sign);    
        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_ai'
method = 'GET'
appid = '您自己的Appid'
sign = "您自己的Sign";
querys = 'appid=appid&sign=sign&keywords=深圳浦发银行&page=1'
bodys = {}
url = host + path + '?' + querys

request = urllib2.Request(url)
request.add_header('Content-Length', '348')
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": "651737541812",
    "remaining": 78,
    "result": {
        "total_items": 2,
        "page_items": 2,
        "curr_page": 1,
        "total_page": 1,
        "data": [
            {
                "bank": "招商银行股份有限公司",
                "provi": "广东省",
                "city": "深圳市",
                "name": "招商银行股份有限公司深圳前海分行营业部",
                "cnaps": 308584001768,
                "status": "1",
                "address": "深圳市前海深港合作区南山街道桂湾片区二单元前海卓越金融中心(一期)09栋A101商业亭8号楼25层2505",
                "tel": "0755-26677519",
                "open_date": "2013-05-27"
            },
            {
                "bank": "招商银行股份有限公司",
                "provi": "广东省",
                "city": "深圳市",
                "name": "招商银行股份有限公司深圳前海企业公馆支行",
                "cnaps": 308584001864,
                "status": "1",
                "address": "深圳市前海深港合作区前湾一路63号前海企业公馆25C栋一层及二层",
                "tel": "0755-86939083",
                "open_date": "2015-10-27"
            }
        ]
    }
}

错误码

代码	说明
401	无效app id
403	签名sign验证错误
405	剩余可使用次数为0
4001	缺少参数keywords，或参数值少于5个汉字
4002	Page参数错误，page须小于等于10，最多展示10页