生活服务 POST /v1/query/lf-bankgeo

银行卡归属地

XS-API-LF-BANKGEO · ¥0.005 / 次

接口说明

查询卡种、发卡行及归属地。提交银行卡号(bankcard,必填)、返回语言(language,可选)。按该接口写明的用途调用。短信和邮件不得用于骚扰或诈骗。

请求方式

请求地址https://sowk.xingsuqy.com/v1/query/lf-bankgeo
请求方法POST
Content-Typeapplication/json
鉴权请求头 X-API-Key

请求参数

nametyperequireddesc
bankcardstring是银行卡号
languagestring否返回语言

返回参数

data 字段结构如下,外层为统一响应结构(见开发文档)。

nametypedesc
bankstring银行名称
card_typestring卡种
provincestring省份
citystring城市

请求示例

curl -X POST https://sowk.xingsuqy.com/v1/query/lf-bankgeo \
  -H "X-API-Key: xs_your_key" \
  -H "Content-Type: application/json" \
  -d '{"bankcard":"6222********1234","language":"zh-CN"}'

返回示例

以下为文档示例,不是本次实时查询结果。请勿把示例数据作为业务判断依据。

{
    "code": 0,
    "message": "success",
    "request_id": "20260919120000abc123",
    "data": {
        "bank": "示例值",
        "card_type": "示例值",
        "province": "北京市",
        "city": "北京市"
    }
}

错误码

codeHTTP说明处理建议
0200成功—
400400参数缺失或格式错误检查 message 指出的参数
401401API Key 缺失或无效在控制台核对 Key
1002402该接口无可用次数联系客服开通
1003403该接口未对当前账户开通联系客服开通
404404接口不存在核对接口编号
429429超出频率限制按 Retry-After 重试

计费说明

本页为接口参考报价。具体套餐、计费口径与开通范围请在申请时确认;提交申请不会扣费。

连接检查

可先检查本站网关是否可达。此检查不查询业务数据、不需要 API Key,也不代表已取得当前接口权限。

curl https://sowk.xingsuqy.com/v1/status

收到 code=0、service=xingsu 表示网关响应正常;正式查询请按上面的请求参数,在服务端使用自己的 API Key。