蜂巢物流公司列表
获取蜂巢定义的启用状态物流公司主表列表
一、接口名称
接口路径: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