查询省份列表

更新时间:2024.11.05

通过本接口获取省份列表数据(不包含中国港澳台地区),可用于省份下的城市数据查询,查询时请注意:

  1. 如需检索,请在前端缓存所有省份数据并自行完成检索功能;

  2. 业务查询到的数据为后端缓存快照,业务方需要定期淘汰并更新数据;

  3. API按照接口-商户级别限频,单商户单接口最大请求频率不超过300TPS;

接口说明

支持商户:【普通服务商】

请求方式:【GET】/v3/capital/capitallhh/areas/provinces

请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

     【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看

请求参数

Header HTTP头参数

Authorization  必填 string

请参考签名认证生成认证信息


Accept  必填 string

请设置为application/json

请求示例

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/capital/capitallhh/areas/provinces \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数

200 OK

data  选填 array[object]

【省份列表】查询到的省份列表数组

属性

total_count  必填 integer

【查询总条数】查询到的省份数据总条数

应答示例

200 OK

1{
2  "data" : [
3    {
4      "province_name" : "广东省",
5      "province_code" : 22
6    }
7  ],
8  "total_count" : 31
9}
10

 

错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

业务错误码

状态码

错误码

描述

解决方案

404

NOT_FOUND

查询结果为空

请商户检查需要查询的ID或者请求URL是否正确

429

FREQUENCY_LIMITED

频率限制

调用太频繁,请降低调用接口频率。

 

 

反馈
咨询
目录
置顶