接口描述

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

请求说明

  • 请求地址 https://47.112.101.83/bank/cnaps_query
  • 请求方式 POST/GET
  • 基本参数
    参数
    appid 请联系管理员获取。联系方式: 微信-13378422016
    sign 根据管理员提供的 app id 和 app secret 生成
  • 请求参数
    参数 是否必填 类型 可选值范围 说明
    bank string 中国境内银行
    (点击查看)
    1. 输入 “工商银行” 或 “中国工商银行股份有限公司” 都可以,等效
    2. 农村商业银行,农村信用社,农村合作银行 等统统填 “农村商业银行”
    provi string 省份/直辖市/自治区 输入 “广西” 或 “广西壮族自治区” 都可以,等效
    city string 地级市/自治州/直辖市 直辖市比如“北京”
    地级市比如“保定”
    请勿输入县级市
    keywords string 任意关键字 银行名称中的关键字
    page int 1~10 分页信息, 第几页。 最多10页。 默认:1

示例代码

function get_cnaps($provi='',$city='',$bank='',$keywords='',$page=1){
        
        $url='https://47.112.101.83/bank/cnaps_query';
  
        $appid="您自己的AppId";
        $appsecret="您自己的Appsecret";
        
        $sign=md5($appid.$appsecret);

        $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://47.112.101.83";
        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://47.112.101.83'
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 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": "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页

©2022 粤ICP备2022016929号 - Powered by 深圳晓芽科技有限公司

welcome login 剩余可用次数: