深入了解快遞100API

一、簡介

快遞100API是一款提供實時查詢快遞物流信息的第三方服務。通過調用快遞100提供的API，可以獲取到快遞包裹的詳細物流信息，包括物流狀態、快遞運費、收件人地址等。快遞100API可以協助商家和客戶更加方便地進行精準的快遞查詢，節省時間和成本，並提高客戶滿意度。

二、使用方法

在使用快遞100API之前，需要在快遞100官網註冊申請API Key，並進行相關配置。API Key是調用快遞100API的必要參數，也是對接快遞100平台的唯一認證憑證，通過API Key的驗證，才可以使用快遞100提供的API服務。

接下來是調用快遞100API的示例代碼：

$api_url = "https://poll.kuaidi100.com/poll/query.do";
$post_data = array();
$post_data["customer"] = ""; // 快遞100用戶ID
$key = ""; // 快遞100 API Key
$post_data["sign"] = md5($post_data["customer"].$key.$post_data["param"]);
$post_data["param"] = '{"com":"yuantong","num":"200382770835","phone":""}';
$post_data["sign"] = strtoupper(md5($post_data["param"].$key.$post_data["customer"]));
$o="";
foreach ($post_data as $k=>$v)
{
    $o.=urlencode($k)."=".urlencode($v)."&"; // 網址編碼，防止中文出現亂碼
}
$post_data=substr($o,0,-1);
$ch = curl_init();
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_URL, $api_url);
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$data = curl_exec($ch);
curl_close($ch);
$result = json_decode($data,true);
print_r($result);

三、常用功能

1. 查詢快遞狀態

查詢快遞狀態是快遞100API的主要功能之一，開發者可以通過查詢快遞單號獲取實時的快遞包裹物流狀態。使用快遞100API，不僅可以獲取到物流狀態，還可以查詢派件員信息、收件人信息、物品信息以及簽收信息等。

以下是通過查詢快遞單號獲取快遞信息的示例代碼：

$api_url = "https://poll.kuaidi100.com/poll/query.do";
$post_data = array();
$post_data["customer"] = ""; // 快遞100用戶ID
$key = ""; // 快遞100 API Key
$post_data["sign"] = md5($post_data["customer"].$key.$post_data["param"]);
$post_data["param"] = '{"com":"yuantong","num":"200382770835","phone":""}';
$post_data["sign"] = strtoupper(md5($post_data["param"].$key.$post_data["customer"]));
$o="";
foreach ($post_data as $k=>$v)
{
    $o.=urlencode($k)."=".urlencode($v)."&"; // 網址編碼，防止中文出現亂碼
}
$post_data=substr($o,0,-1);
$ch = curl_init();
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_URL, $api_url);
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$data = curl_exec($ch);
curl_close($ch);
$result = json_decode($data,true);
print_r($result);

2. 快遞物流信息推送

快遞物流信息推送是指在快遞物流狀態發生變化時，快遞100會將最新狀態推送給指定開發者。這種方式可以實時獲取到快遞物流信息，適合需要及時處理快遞信息的開發者。

以下是接收快遞信息推送的示例代碼：

$url = "https://www.example.com/api/receive";
$data = array();
$data["param"] = '{"company":"yuantong","number":"200382770835","from":"廣東深圳","to":"廣東廣州","sign_name":"張三","sign_time":"2019-06-10 08:10:00","status":"在途中"}';
$post_data = array();
$post_data["customer"] = ""; // 快遞100用戶ID
$key = ""; // 快遞100 API Key
$post_data["param"] = json_encode($data);
$post_data["sign"] = md5($post_data["customer"].$key.$post_data["param"]);
$post_data["callbackurl"] = urlencode($url);
$post_data["salt"] = mt_rand();
$o="";
foreach ($post_data as $k=>$v)
{
    $o.=urlencode($k)."=".urlencode($v)."&";
}
$post_data=substr($o,0,-1);
$url = "https://poll.kuaidi100.com/poll";
$ch = curl_init();
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_HEADER, 0);
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
$data = curl_exec($ch);
curl_close($ch);

3. 訂閱快遞信息

訂閱快遞信息是指開發者向快遞100提交自己想要關注的快遞物流信息，當該快遞信息狀態發生變化時，快遞100會將最新狀態推送給開發者。這種方式可以實時獲取到快遞物流信息，適合需要及時處理快遞信息的開發者。

以下是訂閱快遞信息的示例代碼：

$api_url = "https://api.kuaidi100.com/eorderapi.do";
$post_data = array();
$post_data["company"] = "yuantong"; // 快遞公司編碼
$post_data["from"] = "廣東深圳"; // 發貨地址
$post_data["to"] = "廣東廣州"; // 收貨地址
$post_data["to_phone"] = ""; // 收貨人手機號
$post_data["to_name"] = ""; // 收貨人姓名
$post_data["number"] = "200382770835"; // 快遞單號
$post_data["key"] = ""; // 快遞100 API Key
$post_data["salt"] = mt_rand();
$o="";
foreach ($post_data as $k=>$v)
{
    $o.=urlencode($k)."=".urlencode($v)."&"; // 網址編碼，防止中文出現亂碼
}
$post_data=substr($o,0,-1);
$sign = md5($post_data.$key);
$url = "{$api_url}?sign={$sign}&{$post_data}";
$response = file_get_contents($url);
$result = json_decode($response, true);
print_r($result);

四、最佳實踐

在使用快遞100API時，需要注意以下幾點：

• 根據需要選擇使用快遞100提供的不同API介面；
• 正確定義API請求參數，以保證請求的成功和數據的準確性；
• 對返回的數據進行解析和處理，以便使用。

在實際開發中，還可以通過對接多個API介面、進行數據分析等手段，進一步提高快遞物流信息的效率和準確性。