电商四级地址库查询

电商四级地址库查询,查询全国包括省、市、区、街道等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: 标准行政区域/淘宝, 默认1
parent_code int 0 0表示根级节点,为全国的省级 。 默认0

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": [
    {
      "name": "安徽省",
      "code": "340000",
      "level": 1,
      "level_type": "省"
    },
    {
      "name": "澳门特别行政区",
      "code": "820000",
      "level": 1,
      "level_type": "特别行政区"
    },
    {
      "name": "北京市",
      "code": "110000",
      "level": 1,
      "level_type": "直辖市"
    }
      ],
  "trace_id": "d4cdb1fb-fb68-48c8-996d-cd5a02b8fbe6"
}

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

文档更新时间: 2026-07-20 00:48   作者:admin