## 常用快遞查詢  > 根據快遞單號查詢快遞狀態信息，支持國內常規快遞公司和物流公司，信息更新及時 ## 接口調用（[調用須知](https://docs.topthink.com/think-api/1835086)） ## 接口1：根據單號查詢快遞信息 ### 接口費用（[點擊購買](https://market.topthink.com/product/100)） > 最低 0.008元/次 ### 請求地址 ``` GET https://api.topthink.com/express/query ``` ### 請求參數 | 名稱 | 必填 | 類型 | 說明 | | --- | --- | --- | --- | | appCode| 是 |string| 用戶授權碼，參考[API調用](https://docs.topthink.com/think-api/1835086) | | com | 是 | string | 快遞公司字母簡稱。可以使用auto代替,此時將自動識別快遞單號。【查詢順豐時，為了保證效率，請盡量提供寄件人或者收件人查詢】 | | nu | 是 | string | 需要查詢的快遞單號 | | phone| 否 | string | 手機尾號后四位【寄件人手機號或者收件人手機號】| ### 返回參數 | 參數名稱 | 類型 | 示例值 | 描述 | | --- | --- | --- | --- | | update | Number | 1588071235436 | 更新時間戳 | | upgrade\_info | String | | 提示信息，用于提醒用戶可能出現的情況 | | updateStr | String | 2020-04-28 18:53:55 | 更新時間 | | logo | String | http://app2.showapi.com/img/expImg/zto.jpg | 快遞公司logo | | dataSize | Number | 11 | 數據節點的長度 | | status | Number | 4 | 快遞狀態 1 暫無記錄 2 在途中 3 派送中 4 已簽收 (完結狀態) 5 用戶拒簽 6 疑難件 7 無效單 (完結狀態) 8 超時單 9 簽收失敗 10 退回 | | fee\_num | Number | 1 | 計費次數。例如：0為計費0次，即不計費；1為計費1次 | | tel | String | 95311 | 快遞公司聯系方式 | | data | Object\[\] | | | | -|?time | String | 2019-11-16 21:33:56 | | | -|?context | String | 快件已在 【九江城西港】 簽收, 簽收人: 速遞易, 如有疑問請電聯:（15779254414）, 投訴電話:（13687028760）, 您的快遞已經妥投。風里來雨里去, 只為客官您滿意。上有老下有小, 賞個好評好不好？【請在評價快遞員處幫忙點亮五顆星星哦~】 | | | expSpellName | String | zhongtong | 快遞編碼 | | msg | String | 查詢成功 | 返回提示信息 | | mailNo | String | 75312165465979 | 快遞單號 | | queryTimes | Number | 1 | 無走件記錄時被查詢次數 注意：在24小時內，查詢次數>10次將會計費 | | ret\_code | Number | 0 | 0 查詢成功 或 提交成功。 1 輸入參數錯誤。 2 查不到物流信息。 3 單號不符合規則。 4 快遞公司編碼不符合規則。 5 快遞查詢渠道異常。 6 auto時未查到單號對應的快遞公司,請指定快遞公司編碼。 7 單號與手機號不匹配 其他參數：接口調用失敗 | | flag | Boolean | true | true：查詢成功，表示ret\_code=0且data的長度>0。可使用本字段做是否讀取data列表的依據。 false：查詢失敗。 | | expTextName | String | 中通快遞 | 快遞簡稱 | | possibleExpList | String\[\] | \[\] | 自動識別結果 | ## SDK調用 ``` $client = new Client("YourAppCode"); $result = $client->expressQuery() ->withCom('快遞公司簡稱') ->withNu('運單號') ->request(); ``` ## 接口2：快遞公司列表（免費） ### 請求地址 ``` GET https://api.topthink.com/express/exp_list ``` ### 請求參數 | 名稱 | 必填 | 類型 | 說明 | | --- | --- | --- | --- | | expName| 否 | string | 快遞公司關鍵詞 | | maxSize| 否 | string | 分頁時,返回的最大數據量 | | page| 否 | string | 當前頁數| ### 返回參數 | 名稱 | 類型 | 描述 | | --- | --- | --- | | expressList | String | 快遞公司列表數據 | | - expName | String | 快遞公司名稱 | | - simpleName | String | 簡稱 | | - url | String | 官方網址 | | - note | String | 描述 | | - phone | String | 快遞公司服務電話 | | - imgUrl | String | 快遞公司圖標 | JSON返回示例： ## SDK調用 ``` $client = new Client("YourAppCode"); $result = $client->expressExpList() ->withExpName('如風') ->withMaxSize(20) ->request(); ``` 返回示例： ~~~ { "code":0, "message":"操作成功", "data":{ "page": 1, "expressList": [ { "imgUrl": "http://app2.showapi.com/img/expImg/rufeng.jpg", "simpleName": "rufeng", "phone": "400-010-6660", "expName": "如風達快遞", "note": "", "url": "http://www.rufengda.com" }, { "imgUrl": "http://app2.showapi.com/img/expImg/562.gif", "simpleName": "rufengda", "phone": "400-010-6660", "expName": "凡客如風達", "note": "", "url": "http://www.rufengda.com" } ], "allNum": 2, "msg": "查詢成功!", "maxSize": 20 } } ~~~