接口描述

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

请求说明

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

返回说明

  • 返回格式 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 34165854@qq.com

welcome login 剩余可用次数: