蜂巢物流公司列表

获取蜂巢定义的启用状态物流公司主表列表

一、接口名称

接口路径:POST /gateway/logistics/company/list

请求方式:application/x-www-form-urlencoded


二、请求参数

字段 类型 说明 必需
appid string 合作伙伴 AppId
timestamp string Unix 时间戳(秒)
sign string 请求签名,算法见接入指南

本接口无额外业务参数,仅需公共签名参数。


三、请求示例代码(Java)

 @Test
public void logisticsCompanyList() throws Exception {

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

    String apiUrl = Config.GatewayUrl + "/logistics/company/list";
    String result = doHttpRequest(apiUrl, data);
    System.out.println("result:" + result);
}

四、返回结果

 {
  "code": 0,
  "message": "ok",
  "data": [
    {
      "company_code": "HTKY",
      "standard_name": "极兔快递",
      "official_name": "极兔速递"
    },
    {
      "company_code": "SF",
      "standard_name": "顺丰快递",
      "official_name": "顺丰速运"
    },
    {
      "company_code": "ZTO",
      "standard_name": "中通快递",
      "official_name": "中通快递"
    }
  ]
}

返回字段说明

字段 类型 说明
code number 0 表示成功,非 0 表示失败
message string 错误信息或 ok
data array 物流公司列表
data[].company_code string 蜂巢内部统一编码,如 HTKY、SF、ZTO
data[].standard_name string 蜂巢标准名称,如 极兔快递、顺丰快递
data[].official_name string 官方名称,如 极兔速递、顺丰速运
文档更新时间: 2026-07-02 15:29   作者:admin