注册快递100账号获取customer和key，构造包含com、num等信息的param参数，通过MD5加密生成sign签名，使用curl发送POST请求至https://poll.kuaidi100.com/poll/query.do，接收并解析返回的物流数据，实现PHP物流查询。
要实现PHP调用第三方物流API（如快递100）查询订单，核心步骤包括：注册账号获取Key、选择合适的接口类型（公开或企业版）、构造请求参数、发送HTTP请求并解析返回结果。下面以快递100为例，详细介绍具体实现方法。
注册并获取API权限与密钥
使用快递100等平台前，需先注册开发者账号：
- 访问快递100开放平台，注册并登录
- 进入“我的应用”创建新应用，获取red">customer（客户号）和key（授权Key）
- 确认开通了“智能查询”或“单号识别”接口权限
构造API请求参数
快递100推荐使用POST方式提交JSON数据到指定接口地址。常用接口为：
https://poll.kuaidi100.com/poll/query.do请求头需设置 Content-Type: application/json，请求体包含以下关键字段：
- customer：你在平台获取的customer值
- param：加密后的查询参数（需配合sign生成）
- sign：签名，由param + key + customer 拼接后MD5加密生成
其中 param 是一个JSON字符串，结构如下：
{
"com": "yunda", // 快递公司编码，可为空由系统自动识别
"num": "123456789", // 快递单号
"from": "", // 发货地（可选）
"to": "", // 收货地（可选）
"resultv2": "1" // 是否开启增值功能（1=开启）
}
PHP代码实现示例
以下是一个完整的PHP函数，用于调用快递100物流查询接口：
function queryExpress($expressNo, $companyCode = '') {
$url = 'https://poll.kuaidi100.com/poll/query.do';
$params = [
'com' => $companyCode,
'num' => $expressNo,
'resultv2' => '1'
];
$postData = json_encode($params);
// 替换为你自己的 key 和 customer
$key = 'your_auth_key';
$customer = 'your_customer_number';
$sign = md5($postData . $key . $customer);
$postDataArr = [
'customer' => $customer,
'param' => $postData,
'sign' => strtoupper($sign)
];
$options = [
CURLOPT_URL => $url,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => http_build_query($postDataArr),
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Content-Type: application/x-www-form-urlencoded'],
CURLOPT_TIMEOUT => 30
];
$ch = curl_init();
curl_setopt_array($ch, $options);
$response = curl_exec($ch);
if (curl_error($ch)) {
return ['status' => 'error', 'msg' => curl_error($ch)];
}
curl_close($ch);
return json_decode($response, true);
}
// 调用示例
$result = queryExpress('YT123456789', 'yuantong');
print_r($result);
返回结果中常见字段：
- status：状态码（200表示成功）
- message：返回信息
- data：物流轨迹数组，包含时间、描述、城市等信息
- state：物流状态（3=已签收，2=运输中，1=揽件等）
注意事项与优化建议
实际开发中需要注意以下几点：
- 频繁请求需控制频率，避免被限流（建议间隔≥1秒）
- 对返回结果做缓存处理（如Redis），减轻API压力
- 单号对应快递公司可通过“自动识别”接口预先获取
- 生产环境应增加异常捕获和重试机制
- 企业版接口支持订阅模式（主动推送更新），适合高并发场景
