接口描述

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

请求说明

  • 请求地址 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://47.112.101.83/bank/cnaps_ai';
  
        $appid="您自己的AppId";
        $appsecret="您自己的Appsecret";
        
        $sign=md5($appid.$appsecret);

        $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://47.112.101.83";
        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://47.112.101.83'
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 int 唯一的请求编号
    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页

©2024 粤ICP备2022016929号 - Powered by 深圳晓芽科技有限公司增值电信业务经营许可证:粤B2-20221644

welcome login 剩余可用次数: