通八洲科技

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

日期:2025-11-18 00:00 / 作者:絕刀狂花
注册快递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等平台前,需先注册开发者账号:

构造API请求参数

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

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

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

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

返回结果中常见字段:

注意事项与优化建议

实际开发中需要注意以下几点:

基本上就这些,按照流程配置好密钥、正确拼接参数并处理响应,即可在PHP项目中稳定查询物流信息