联行号查询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条数据

示例代码

import okhttp3.*;
import java.io.IOException;
import java.util.concurrent.TimeUnit;

public class OkHttpClientExample {

    // 创建全局 OkHttpClient 实例 (建议单例模式)
    private static final OkHttpClient client = new OkHttpClient.Builder()
            .connectTimeout(5, TimeUnit.SECONDS)
            .readTimeout(5, TimeUnit.SECONDS)
            .build();

    public static void main(String[] args) {
        String host = "https://api.cwjyz.com.cn";
        String path = "/bank/cnaps_query";
        
        // 【重要】请替换为真实值
        String appid = "你的真实AppId";
        String sign = "你的真实Sign";

        // 构建 HttpUrl (自动处理参数拼接和编码)
        HttpUrl url = new HttpUrl.Builder()
                .scheme("https")
                .host("api.cwjyz.com.cn") // 注意：host 中不要带 https://
                .addPathSegments(path.substring(1)) // 去掉开头的 /
                .addQueryParameter("appid", appid)
                .addQueryParameter("sign", sign)
                .addQueryParameter("bank", "平安银行")
                .addQueryParameter("provi", "黑龙江")
                .addQueryParameter("city", "哈尔滨")
                .addQueryParameter("keywords", "分行")
                .addQueryParameter("page", "1")
                .build();

        Request request = new Request.Builder()
                .url(url)
                .get() 
                .build();

        try (Response response = client.newCall(request).execute()) {
            if (!response.isSuccessful()) {
                throw new IOException("Unexpected code " + response);
            }
            
            String responseBody = response.body().string();
            System.out.println("请求成功：");
            System.out.println(responseBody);
            
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

function get_cnaps($provi = '', $city = '', $bank = '', $keywords = '', $page = 1) {
    
    $baseUrl = 'https://api.cwjyz.com.cn/bank/cnaps_query';
    
    // 【重要】请替换为你真实的 AppId 和 Sign
    $appid = "你的真实AppId"; 
    $sign  = "你的真实Sign";

    // 2. 构建参数字典
    $params = array(
        'appid'    => $appid,
        'sign'     => $sign,
        'provi'    => $provi,
        'city'     => $city,
        'bank'     => $bank,
        'keywords' => $keywords,
        'page'     => $page
    );

    // 3. 拼接查询字符串
    $queryString = http_build_query($params);
    $fullUrl = $baseUrl . '?' . $queryString;

    // 4. 初始化 CURL
    $curl = curl_init();
    
    // 5. 设置 CURL 选项
    curl_setopt($curl, CURLOPT_URL, $fullUrl); 
    curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false); // 跳过 SSL 证书验证 (开发环境常用，生产环境建议配置证书)
    curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
    curl_setopt($curl, CURLOPT_POST, false);        
    curl_setopt($curl, CURLOPT_POSTFIELDS, null); 
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); // 返回字符串而不是直接输出
    curl_setopt($curl, CURLOPT_TIMEOUT, 20);          // 设置超时时间 20 秒

    // 6. 执行请求
    $output = curl_exec($curl);
    
    // 7. 网络层错误处理
    if ($output === false) {
        $error = curl_error($curl);
        curl_close($curl);
        throw new Exception("CURL 请求失败: " . $error);
    }
    
    $httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
    curl_close($curl);

    // 8. 业务层状态码处理
    if ($httpCode != 200) {        
        return ["error" => "HTTP Status: " . $httpCode, "response" => $output];
    }

    // 9. 解析 JSON 并返回数组
    return json_decode($output, true);
    
}

import urllib.request
import urllib.parse

# 配置参数（请替换为真实值）
host = 'https://api.cwjyz.com.cn'
path = '/bank/cnaps_query'

appid = '您的真实Appid'
sign = '您的真实Sign'

# 如下变量请替换为真实值：
params = {
    'appid': appid,
    'sign': sign,
    'bank': '工商银行',
    'provi': '北京市',
    'city': '北京',
    'keywords': '海淀支行',
    'page': '1'
}

query_string = urllib.parse.urlencode(params)
url = host + path + '?' + query_string

request = urllib.request.Request(url)

with urllib.request.urlopen(request) as response:
    content = response.read().decode('utf-8')

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页