电商四级地址库

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

配置说明

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

一、请求参数

请求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

二、请求示例代码

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);

    }

三、返回结果

返回示例如下:

{
  "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会有失败原因。