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

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

絕刀狂花

发布： 2025-11-18 18:05:50

原创

139人浏览过

注册快递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开放平台，注册并登录
进入“我的应用”创建新应用，获取red">customer（客户号）和key（授权Key）
确认开通了“智能查询”或“单号识别”接口权限

构造API请求参数

快递100推荐使用POST方式提交JSON数据到指定接口地址。常用接口为：

https://poll.kuaidi100.com/poll/query.do

请求头需设置 Content-Type: application/json，请求体包含以下关键字段：

立即学习“PHP免费学习笔记（深入）”；

绘ai

ai绘图提示词免费分享

153

查看详情

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);

登录后复制

返回结果中常见字段：