注册快递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开放平台,注册并登录 进入“我的应用”创建新应用,获取customer(客户号)和key(授权Key) 确认开通了“智能查询”或“单号识别”接口权限
构造API请求参数
快递100推荐使用POST方式提交JSON数据到指定接口地址。常用接口为:
https://poll.kuaidi100.com/poll/query.do
请求头需设置 Content-Type: application/json,请求体包含以下关键字段:
立即学习“PHP免费学习笔记(深入)”;
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压力 单号对应快递公司可通过“自动识别”接口预先获取 生产环境应增加异常捕获和重试机制 企业版接口支持订阅模式(主动推送更新),适合高并发场景基本上就这些,按照流程配置好密钥、正确拼接参数并处理响应,即可在PHP项目中稳定查询物流信息。
以上就是如何实现PHP调用第三方物流API查询订单_PHP第三方物流API(如快递100)订单查询教程的详细内容,更多请关注php中文网其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1336263.html
微信扫一扫
支付宝扫一扫