随着线上购物持续增长，电商业务链路覆盖订单创建、商品打包、出库发货、干线运输、末端取件、售后退换货全流程。面对海量订单，依靠人工录入快递单号查询物流状态，不仅耗费大量人力，还容易出现漏查、错查，已经无法支撑规模化快递业务运营。
一、PHP调用示例
<?php
$host = "https://market.aliyun.com/detail/cmapi00065859";#接口地址
$path = "/exp/index";
$method = "GET";
$appcode = "你自己的AppCode";
$headers = array();
array_push($headers, "Authorization:APPCODE " . $appcode);
$querys = "no=78792812069699&phone=phone&com=com";
$bodys = "";
$url = $host . $path . "?" . $querys;
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, true);
if (1 == strpos("$".$host, "https://"))
{
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
}
var_dump(curl_exec($curl));
?>
二、接口请求参数说明
请求参数
数据来源：探数API
com（快递公司编码）：非必填。可调用子接口【快递公司查询】获取编码列表；不传时接口会自动识别快递单号所属快递公司。生产环境建议传入准确编码，提升识别准确率与接口响应速度。no（快递单号）：必填，包裹运单编号。
三、接口返回JSON示例
{
"code": 1,
"msg": "操作成功",
"data": {
"company": "中通快递", //快递公司名称
"com": "zto", //快递公司编码
"no": "787111111169699", //快递单号
"com_phone": "95311", //快递公司联系方式
"com_url": "www.zto.cn", //快递公司网址
"take_time": "4天17小时8分", //物流轨迹耗时
"courier_phone": "18111111061", //快递员联系方式
"status_desc": "已签收", //签收状态文案
"status_detail": 4, //当前节点状态 1 揽件 2 运输中 3 派送中 4 已签收 5 包裹异常/签收失败 10 退回
"list": [
{
"datetime": "2026-09-04 15:58:17", //物流时间
"remark": "【东莞市】已签收，签收人凭取货码签收，如有疑问请电联：0769-33550361/ 0769-33550361。感谢使用中通快递，期待再次为您服务！" //节点详细信息
},
{
"datetime": "2026-09-01 15:17:14",
"remark": "【东莞市】东莞樟木头 的业务员【李杨,1811111161】正在为您派件（95720为中通快递员外呼专属号码，请放心接听，如有问题可联系网点:0769-33550361,投诉电话:13011111100）"
},
{
"datetime": "2026-09-01 14:30:07",
"remark": "【东莞市】 快件已到达 东莞樟木头"
},
{
"datetime": "2026-08-31 05:13:53",
"remark": "【南宁市】 快件已到达 南宁转运中心"
},
{
"datetime": "2026-08-30 22:50:05",
"remark": "【南宁市】 快件已发往 南宁转运中心"
},
{
"datetime": "2026-08-30 22:49:35",
"remark": "【南宁市】 南宁建工城（0771-7711792,19111111101）项目部-漫花（1911111501） 已揽收"
}
]
}
}
返回字段解读
status_detail：业务核心状态码，用于后端状态判断、消息推送逻辑开发。- 1：揽件；2：运输中；3：派送中；4：已签收；5：包裹异常/签收失败；10：退回
list：物流轨迹数组，按时间倒序排列，前端直接循环渲染即可展示物流时间线。
四、业务应用场景
前台C端场景
- 商城网站、小程序、APP订单详情页
用户进入订单页面自动加载物流轨迹；也支持用户单独输入单号查询包裹。 - 快递查询工具类小程序/H5
轻量查件工具，底层依赖该API，输入单号自动识别快递公司，一键获取完整物流信息。
B端商家后台场景
- ERP、OMS、WMS订单管理系统
系统定时拉取物流状态，自动更新订单状态；监控揽收、在途、签收节点，统计发货时效，生成物流报表。 - 物流节点消息推送
轮询监听物流状态变更，自动推送短信通知，减少客服咨询量。
