如何实现PHP调用第三方物流API查询订单_PHP第三方物流API(如快递100)订单查询教程

注册快递100账号获取customer和key,构造包含com、num等信息的param参数,通过MD5加密生成sign签名,使用curl发送POST请求至https://poll.kuaidi100.com/poll/query.do,接收并解析返回的物流数据,实现PHP物流查询。

如何实现php调用第三方物流api查询订单_php第三方物流api(如快递100)订单查询教程

要实现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

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年12月12日 21:59:42
下一篇 2025年12月12日 21:59:53

相关推荐

发表回复

登录后才能评论
关注微信