电商四级地址库查询

电商四级地址库查询,查询全国包括省、市、区、街道等4级地址库。 如果特定电商场景要用到对应的地址code,则传入对应电商平台标识。

配置说明

  1. 是否需要商家授权:不需要
  2. 权限名称:电商四级地址库查询

1.请求参数:

请求URL:

POST https://kf.fw199.com/gateway/addr/query

参数名称 参数类型 是否必须 示例值 参数描述
appid String 合作伙伴AppId
timestamp String 1657525936 当前Unix时间戳,秒
sign String
op int 1 1:淘宝
parent_code int 0 0表示根级节点,为全国的省级
name String 三里屯 省或市或区或街道的名称,配合level参数
level String Town 表示查询哪级地址,如:Province :省,City:市 ,District :(区), Town: 街道,配合name参数

2. 请求示例代码(Java)

  @Test
    public void addrQuery() throws Exception {

        Map<String, String> data = new HashMap<String, String>();
        data.put("appid",  Config.AppId);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("op","1" );
        data.put("parent_code","0" );
        // 参数签名
        data.put("sign", Utils.Sign(data,Config.AppSecret));
        doHttpRequest(Config.AddrQueryUrl, data);

    }

3. 返回结果

返回结果如下

{
  "code": 0,
  "message": "ok",
  "data": [
    {
      "parent_code": 0,
      "code": 310000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "上海",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 530000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "云南省",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 150000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "内蒙古自治区",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 110000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "北京",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 220000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "吉林省",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 510000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "四川省",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 120000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "天津",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 640000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "宁夏回族自治区",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 340000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "安徽省",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 370000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "山东省",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 140000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "山西省",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 440000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "广东省",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 450000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "广西壮族自治区",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 650000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "新疆维吾尔自治区",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 320000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "江苏省",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 360000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "江西省",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 130000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "河北省",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 410000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "河南省",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 330000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "浙江省",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 460000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "海南省",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 420000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "湖北省",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 430000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "湖南省",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 620000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "甘肃省",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 350000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "福建省",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 540000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "西藏自治区",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 520000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "贵州省",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 210000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "辽宁省",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 500000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "重庆",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 610000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "陕西省",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 630000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "青海省",
      "level": "Province",
      "op": 1
    },
    {
      "parent_code": 0,
      "code": 230000000000,
      "province": "",
      "city": "",
      "district": "",
      "name": "黑龙江省",
      "level": "Province",
      "op": 1
    }
  ],
  "trace_id": ""
}

返回code为0表示成功, 非0为失败,失败时message会有失败原因。

文档更新时间: 2025-03-21 14:38   作者:admin