查询联行号信息 - 统一开放平台（正式）

请求参数

Query 参数

appId

string

必需

对接系统的appId

示例值:

1592057387467018240

systemCode

string

企业对接系统的编码

必需

示例值:

ERP

command

string

接口指令码

必需

示例值:

yocyl.basic.bank.location.query

version

string

调用的接口版本

必需

示例值:

1.0.0

timestamp

string

必需

发送请求的时间，格式"yyyyMMddHHmmss",请求时间10分钟内有效

charset

string

仅支持UTF-8

必需

示例值:

UTF-8

format

string

仅支持json

必需

示例值:

json

signType

string

必需

签名算法类型，目前支持RSA2，RSA，SM2，推荐使用RSA2

示例值:

RSA2

sign

string

请求参数的签名串

必需

notifyUrl

string

必需

主动通知企业业务系统服务器里指定的页面http/https路径

Body 参数application/json

countryCode

string | null

国家或地区编码

必需

bankCode

string | null

银行编码

必需

areaCode

string | null

区域编码

必需

lastDateTime

string | null

最后更新时间

必需

查询联行号最后更新时间在该时间以后的；yyyyMMddHHmmss

pageNo

number | null

页码

必需

留空标示第一页，默认 20个结果为一页

pageSize

number | null

每页记录数

必需

默认100，最大 1000

示例

{
    "countryCode": "string",
    "bankCode": "string",
    "areaCode": "string",
    "lastDateTime": "string",
    "pageNo": 0,
    "pageSize": 0
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://openapi-pre.yocyl.com/api?appId=1592057387467018240&systemCode=ERP&command=yocyl.basic.bank.location.query&version=1.0.0&timestamp=&charset=UTF-8&format=json&signType=RSA2&sign=&notifyUrl=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "countryCode": "string",
    "bankCode": "string",
    "areaCode": "string",
    "lastDateTime": "string",
    "pageNo": 0,
    "pageSize": 0
}'

返回响应

🟢200成功

application/json

Body

yocyl_basic_bank_location_query_response

object

必需

code

string

响应码

必需

msg

string

响应信息

必需

currentPageNo

integer

当前页码

必需

pageSize

integer

每页大小

必需

total

integer

数据总数

必需

totalPages

integer

总页数

必需

records

array [object {10}]

返回数据集合

必需

sign

string

必需

示例

{
    "yocyl_basic_bank_location_query_response": {
        "code": "string",
        "msg": "string",
        "currentPageNo": 0,
        "pageSize": 0,
        "total": 0,
        "totalPages": 0,
        "records": [
            {
                "bankCode": "string",
                "bankName": "string",
                "countryCode": "string",
                "countryName": "string",
                "areaCode": "string",
                "areaName": "string",
                "bankLocationCode": "string",
                "bankLocationName": "string",
                "lastUpdateTime": "string",
                "active": true
            }
        ]
    },
    "sign": "string"
}