电商四级地址库查询
电商四级地址库查询,查询全国包括省、市、区、街道等4级地址库。 如果特定电商场景要用到对应的地址code,则传入对应电商平台标识。
配置说明
- 是否需要商家授权:不需要
- 权限名称:电商四级地址库查询
1.请求参数:
请求URL:
| 参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
|---|---|---|---|---|
| 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