电商四级地址邮编查询

根据街道行政区划信息查询邮编，支持两种查询方式（二选一）：

1. 按街道行政区划代码（street_code）查询, 如果有传入street_code则优先于方式2
2. 按省、市、区、街道名称查询

一、接口名称

• 接口名称：电商四级地址邮编查询
• 接口地址：https://kf.fw199.com/gateway/addr/zipcode
• 请求方式：POST
• Content-Type：application/x-www-form-urlencoded

二、请求参数

公共参数

业务参数

说明：

• street_code 与 province+city+district+street 二选一
• 同时传两类参数时，优先按 street_code 查询
• 仅查询 level=4（街道/镇）记录

三、请求示例代码（Java）

方式一：按省市区街道查询

@Test
public void addrZipcodeByAddress() throws Exception {

    // 业务参数
    Map<String, String> data = new HashMap();
    data.put("appid", Config.AppId);
    Long timestamp = System.currentTimeMillis();
    data.put("timestamp", timestamp.toString());
    data.put("op", "1");
    data.put("province", "湖北省");
    data.put("city", "湖北省辖县");
    data.put("district", "潜江市");
    data.put("street", "杨市街道");
    // 参数签名
    data.put("sign", Utils.Sign(data, Config.AppSecret));
    String result = doHttpRequest(apiUrl, data);
    System.out.println("result:" + result);
}

方式二：按街道 code 查询

@Test
public void addrZipcodeByStreetCode() throws Exception {

    // 业务参数
    Map<String, String> data = new HashMap();
    data.put("appid", Config.AppId);
    Long timestamp = System.currentTimeMillis();
    data.put("timestamp", timestamp.toString());
    data.put("op", "1");
    data.put("street_code", "429005001");
    // 参数签名
    data.put("sign", Utils.Sign(data, Config.AppSecret));
    String result = doHttpRequest(apiUrl, data);
    System.out.println("result:" + result);
}

四、返回结果

说明：最外层 code 为 0 表示成功，非 0 为失败，最外层 message 会包含失败原因。

4.1 成功示例

{
    "code": 0,
    "message": "ok",
    "data": {
        "code": "429005001",
        "street": "园林街道",
        "province": "湖北省",
        "city": "湖北省辖县",
        "district": "潜江市",
        "level": 4,
        "level_type": "街道",
        "zip_code": 433199
    },
    "trace_id": "e2be3d8a-e006-4b5d-b680-4ca5cc266a1a"
}

4.2 data 字段说明

4.3 失败示例

{
  "code": 2,
  "message": "请传街道 code，或同时传 province/city/district/street"
}

{
  "code": 3,
  "message": "未找到对应街道邮编"
}