關注快遞100接口API

打印類接口
-云打印API(new)
物流跟蹤類接口
-訂閱推送API
-實時查詢API
增值服務接口
-短信接口API

實時查詢API

  • 簡介:快遞100實時快遞查詢接口是快遞100針對客服人員查詢、最終用戶查詢等必須通過實時查詢的形式獲得運單的物流跟蹤信息的場景推出的一項增值服務,服務整個過程是:貴司主動請求快遞100的接口,快遞100即時查詢物流跟蹤信息并在查詢后立即向貴司返回查詢結果。由于快遞公司系統的承壓能力是有限的,所以請勿大批量地、高頻率地、重復性地調用本接口,僅用于如貴司網站或APP的最終用戶主動點擊時才觸發調用本接口進行查詢,其他的系統自動更新運單簽收狀態等管理類需求請繼續使用快遞100信息推送服務。
1、應用場景
由于快遞公司系統的承壓能力是有限的,所以請勿大批量地、高頻率地、重復性地調用本接口,僅用于如貴司網站或APP的最終用戶主動點擊時才觸發調用本接口進行查詢,其他的系統自動更新運單簽收狀態等管理類需求請繼續使用快遞100信息推送服務。
2、是否需要授權
是,需要申請。
免費申請API
3、請求地址
正式環境請求地址:https://poll.kuaidi100.com/poll/query.do
4、請求類型
post

龙珠激斗v0攻略 www.ovdmu.icu 5.輸入參數

名稱 類型 是否必需 示例值   描述
customer String 我方分配給貴司的的公司編號, 請參考郵件《快遞100-企業版快遞查詢接口(API)——授權key及相關工具》
sign String 簽名, 用于驗證身份, 按param + key + customer 的順序進行MD5加密(注意加密后字符串一定要轉大寫), 不需要加上“+”號, 如{"com": "yuantong", "num": "500306190180", "from": "廣東省深圳市", "to": "北京市朝陽區"}xxxxxxxxxxxxyyyyyyyyyyy yyyyyyyyyyyyyyyyyyyyy
param Object 由其他字段拼接
└ com string yuantong 查詢的快遞公司的編碼, 一律用小寫字母
└ num string 12345678 查詢的快遞單號, 單號的最大長度是32個字符
└ phone string 13888888888 寄件人或收件人手機號(順豐單號必填)
└ from string 廣東深圳 出發地城市
└ to string 北京朝陽 目的地城市,到達目的地后會加大監控頻率
└ resultv2 int 1 添加此字段表示開通行政區域解析功能

6.返回結果

字段名稱   字段含義
message 消息體,請忽略
state 快遞單當前狀態,包括0在途,1攬收,2疑難,3簽收,4退簽,5派件,6退回等7個狀態
status 通訊狀態,請忽略
condition 快遞單明細狀態標記,暫未實現,請忽略
ischeck 是否簽收標記,請忽略,明細狀態請參考state字段
com 快遞公司編碼,一律用小寫字母
nu 單號
data 最新查詢結果,數組,包含多項,全量,倒序(即時間最新的在最前),每項都是對象,對象包含字段請展開
?└ context 內容
?└ time 時間,原始格式
?└ ftime 格式化后時間

7.返回示例

JSON格式
  {
        "message":"ok",
        "state":"0",
        "status":"200",
        "condition":"F00",
        "ischeck":"0",
        "com":"yuantong",
        "nu":"V030344422",
        "data":[
        {
          "context":"上海分撥中心/裝件入車掃描 ",
          "time":"2012-08-28 16:33:19",
          "ftime":"2012-08-28 16:33:19",
        },
        {
          "context":"上海分撥中心/下車掃描 ",
          "time":"2012-08-27 23:22:42",
          "ftime":"2012-08-27 23:22:42",
        }]
  }
         

8. 請求示例代碼

<?php
    //參數設置
    $post_data = array();
    $post_data["customer"] = '*****';
    $key= '*****' ;
    $post_data["param"] = '{"com":"*****","num":"*****"}';

    $url='//poll.kuaidi100.com/poll/query.do';
    $post_data["sign"] = md5($post_data["param"].$key.$post_data["customer"]);
    $post_data["sign"] = strtoupper($post_data["sign"]);
    $o="";
    foreach ($post_data as $k=>$v)
    {
        $o.= "$k=".urlencode($v)."&";		//默認UTF-8編碼格式
    }
    $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,$url);
        curl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);
        $result = curl_exec($ch);
        $data = str_replace("\"",'"',$result );
        $data = json_decode($data,true);
?>