如何对接快递助手物流查询接口【干货】
一、前置準備
1、注冊賬號:在快遞助手物流軌跡官網注冊一個賬號,網址如下:
快遞助手開放平臺物流查詢
2、獲取appkey:登錄后在應用管理》應用設置中新建一個應用。審核(一般十幾分鐘到1個小時)通過后就可以使用appkey和appsecret進行接口調試
二、選擇適合自己的調用場景
| 應用場景 | 1、需要結合網站/商城的需求在頁面上展示快遞信息 2、需要通過快遞信息完善網站/商城的物流業務場景 | 1、不需要自己開發快遞信息展示頁面,跳轉到快遞助手提供的H5頁面直接展示快遞查詢結果 | 1、需要結合地圖展示快遞信息(運輸位置、預計抵達時間等) | 1、在網站首頁等位置開一個查詢輸入框,嵌入代碼即可 |
| 文檔鏈接 | kdzs.logistics.trace.search(物流軌跡查詢:實時查詢) | kdzs.logistics.trace.h5.get(物流軌跡H5嵌入頁) | kdzs.logistics.trace.map.get(物流軌跡地圖獲取) | 物流查詢小插件 |
| 是否傳參 | 是 | 是 | 是 | 否 |
1、物流實時查詢
(1)請求地址:https://gw.kuaidizs.cn/open/api
(2)請求參數:接口名稱、APPkey、快遞公司編碼、快遞運單號、收件人或寄件人手機號后四位(僅順豐和豐網需要傳)
(3)返回結果:物流流轉明細、快遞公司名稱、最新物流狀態、物流流轉最新文字描述、物流流轉最新變更時間
2、物流查詢跳轉頁(H5形式)
(1)請求地址:https://gw.kuaidizs.cn/open/api
(2)請求參數:接口名稱、APPkey、快遞公司編碼、快遞運單號、收件人或寄件人手機號后四位(僅順豐和豐網需要傳)
(3)返回結果:物流查詢跳轉頁鏈接。示例鏈接:https://openapi.kdzs.com/#/h5/searchApiPage/?traceCode=ff2b57e6ada0bea6f81e2e27228103dc
3、物流軌跡地圖(H5形式)
(1)請求地址:https://gw.kuaidizs.cn/open/api
(2)請求參數:接口名稱、APPkey、快遞公司編碼、快遞運單號、出發地-省市區、目的地-省市區、收件詳細地址
(3)返回結果:物流軌跡地圖H5鏈接。示例鏈接:https://openapi.kdzs.com/#/toolRes/amap?trackMapCode=d0db9c3d56c5d6cf9243322271b47940
4、物流查詢小插件
在商戶網站首頁開一個查詢輸入框,輸入以下代碼即可
<!-- <head> --><!-- 樣式引入 --><link rel="stylesheet" href="//openapi.kdzs.com/kdzstrack.min.css"><!-- </head> --><!-- <body> --><!--單號輸入框 --><input type="text" id="num" maxlength="50"/><!--用于調用腳本方法的按鈕 --><input type="button" value="TRACK" onclick="onQuery()"/><!--用于顯示快遞查詢結果的容器 --><div id="custom-container"></div><!--腳本代碼可放于頁面底部,等到頁面最后執行。--><script type="text/javascript" src="//openapi.kdzs.com/kdzstrack.min.js"></script><script type="text/javascript">const track = new KDZSTrack({container: '#custom-container',// (可選)查詢結果內容區域的寬度,不指定默認獲取ID為custom-container節點的寬度containerWidth: 1000,// (可選)查詢結果內容區域的高度containerHeight: 300})function onQuery() {const num = document.getElementById("num").value.trim();if(num === ""){alert("請輸入運單號."); return;}track.searchSingle({// 運單號num: num,// (可選)快遞公司編碼,攜帶該參數會增加結果的準確性// code: 'SF'});}</script><!-- </body> -->5、單號智能識別
(1)請求地址:https://gw.kuaidizs.cn/open/api
(2)請求參數:接口名稱、APPkey、快遞運單號
(3)返回結果:單號識別匹配的快遞公司列表(包含快遞公司編碼和快遞公司名稱)
6、快遞公司編碼
| 1 | YTO | 圓通快遞 |
| 2 | YUNDA | 韻達快遞 |
| 3 | ZTO | 中通快遞 |
| 4 | ZTOKY | 中通快運 |
| 5 | STO | 申通快遞 |
| 6 | HTKY | 百世快遞 |
| 7 | BESTQJT | 百世快運 |
| 8 | JT | 極兔快遞 |
| 9 | POSTB | 郵政國內小包 |
| 10 | POST | 中國郵政 |
| 11 | EMS | EMS |
| 12 | SF | 順豐速運 |
| 13 | FW | 豐網速運 |
| 14 | JD | 京東快遞 |
| 15 | KYE | 跨越速運 |
| 16 | DBKD | 德邦快遞 |
| 17 | XFWL | 信豐快遞 |
| 18 | UC | 優速快遞 |
| 19 | TTKDEX | 天天快遞 |
| 20 | EYB | EMS快遞包裹/郵政快遞包裹 |
| 21 | ZJS | 宅急送 |
| 22 | ANE56 | 安能 |
| 23 | LB | 龍邦 |
| 24 | FAST | 快捷 |
| 25 | DBL | 德邦物流 |
| 26 | DBKY | 德邦快運 |
| 27 | ZTKY | 中鐵物流/飛豹快遞 |
| 28 | CRE | 中鐵快運 |
| 29 | SURE | 速爾快遞 |
| 30 | UAPEX | 全一快遞 |
| 31 | CNEX | 佳吉快運 |
| 32 | CP449455 | 京廣速運 |
| 33 | JYM | 加運美速遞 |
| 34 | YDKY | 韻達快運 |
| 35 | FEDEX | 聯邦快遞 |
| 36 | POSTBK | 郵政標準快遞 |
| 37 | RRS | 日日順 |
| 38 | SNWL | 蘇寧快遞 |
| 39 | ZMKM | 丹鳥 |
| 40 | RFD | 如風達 |
| 41 | YCKY | 遠成快運 |
| 42 | JYSCM | 九曳供應鏈 |
| 43 | CP468398 | 圓通承諾達 |
| 44 | GTO | 國通 |
| 45 | QFKD | 全峰 |
| 46 | SDSD | 山東遞速 |
| 47 | CP443514 | 百世云配 |
| 48 | LE10032270 | 韻達同城 |
| 49 | PADTF | 平安達騰飛 |
| 50 | YMDD | 壹米滴答 |
| 51 | HOAU | 天地華宇 |
| 52 | STOKY | 申通快運 |
| 53 | CP471906 | 順心捷達 |
| 54 | EWINSHINE | 萬象物流 |
| 55 | QRT | 全日通 |
| 56 | GZFY | 凡宇快遞 |
| 57 | XBWL | 新邦物流 |
| 58 | CAE | 民航快遞 |
| 59 | FEC | 銀捷速遞 |
| 60 | SFWL | 盛豐物流 |
| 61 | HLWL | 恒路物流 |
| 62 | JIAYI | 佳怡物流 |
| 63 | LTS | 聯昊通 |
| 64 | SZSA56 | 圣安物流 |
| 65 | SHENGHUI | 盛輝物流 |
| 66 | YTZG | 運通中港快遞 |
| 67 | HMJ | 黃馬甲配送 |
| 68 | CHENGBANG | 晟邦物流 |
| 69 | GZLT | 飛遠配送 |
| 70 | HZABC | 飛遠(愛彼西)配送 |
| 71 | JDYWL | 筋斗云物流 |
| 72 | BJCS | 城市一百物流 |
| 73 | YCT | 黑貓宅急便 |
| 74 | ONTRAC | OnTrac |
| 75 | CITYLINK | City-Link |
| 76 | COE | COE |
| 77 | DTW | 大田物流 |
| 78 | EES | 百福東方 |
| 79 | MBEX | 民邦快遞 |
| 80 | HQKY | 華企快運 |
| 81 | YFEXPRESS | 越豐物流 |
| 82 | AIR | 亞風速遞 |
| 83 | MANCOWL | 萬家物流 |
| 84 | SZML56 | 明亮物流 |
| 85 | CXCOD | 傳喜物流 |
| 86 | D4PX | 遞四方 |
| 87 | TNT | TNT |
| 88 | UPS | UPS |
| 89 | USPS | USPS |
| 90 | DHLCN | DHL中國 |
| 91 | EMSGJ | EMS國際 |
| 92 | CNPOSTGJ | 郵政國際包裹 |
| 93 | DHLDE | DHL德國 |
| 94 | KERRYEAS | 嘉里大通 |
| 95 | DHL | DHL全球 |
| 96 | FEDEXUS | FedEx美國 |
| 97 | FEDEXCN | FedEx中國 |
| 98 | ARAMEX | Aramex |
| 99 | SANTAI | 三態速遞 |
| 100 | OCS | OCS |
| 101 | MYAAE | AAE全球專遞 |
| 102 | YWWL | 燕文物流 |
| 103 | ASENDIA | Asendia USA |
| 104 | RUSTON | 俄速通 |
| 105 | XLOBO | 貝海國際速遞 |
| 106 | SPSR | 中俄快遞 |
| 107 | SAD | 賽澳遞 |
| 108 | SUIJIAWL | 穗佳物流 |
| 109 | ROYALMAIL | 英國皇家郵政 |
| 110 | JKYZ | 捷克郵政 |
| 111 | BLYZ | 波蘭郵政 |
| 112 | FGYZ | 法國郵政 |
| 113 | POSTTR | 土耳其郵政 |
| 114 | POSTCL | 智利郵政 |
| 115 | POSTBY | 白俄羅斯郵政 |
| 116 | POSTES | 西班牙郵政 |
| 117 | POSTUA | 烏克蘭郵政 |
| 118 | POSTNO | 挪威郵政 |
| 119 | POSTZA | 南非郵政 |
| 120 | POSTPT | 葡萄牙郵政 |
| 121 | POSTSA | 沙特郵政 |
| 122 | POSTIN | 印度郵政 |
| 123 | POSTBG | 保加利亞郵政 |
| 124 | POSTAE | 阿聯酋郵政 |
| 125 | POSTAU | 澳大利亞郵政 |
| 126 | POSTPK | 巴基斯坦郵政 |
| 127 | POSTMT | 馬耳他郵政 |
| 128 | POSTLB | 黎巴嫩郵政 |
| 129 | POSTMD | 摩爾多瓦郵政 |
| 130 | POSTSRB | 塞爾維亞郵政 |
| 131 | POSTHR | 克羅地亞郵政 |
| 132 | POSTAM | 亞美尼亞郵政 |
| 133 | POSTMK | 馬其頓郵政 |
| 134 | POSTFI | 芬蘭郵政 |
| 135 | POSTAR | 阿根廷郵政 |
| 136 | POSTSK | 斯洛伐克郵政 |
| 137 | SERPOST | 秘魯郵政 |
| 138 | POSTIT | 意大利郵政 |
| 139 | POSTSI | 斯洛文尼亞郵政 |
| 140 | POSTHU | 匈牙利郵政 |
| 141 | POSTMU | 毛里求斯郵政 |
| 142 | POSTAT | 奧地利郵政 |
| 143 | POSTAL | 阿爾巴尼亞郵政 |
| 144 | POSTEE | 愛沙尼亞郵政 |
| 145 | POSTLV | 拉脫維亞郵政 |
| 146 | POSTCO | 哥倫比亞郵政 |
| 147 | POSTBR | 巴西郵政 |
| 148 | POSTCH | 瑞士郵政 |
| 149 | BLSYZ | 比利時郵政 |
| 150 | RBYZEMS | 日本郵政 |
| 151 | EPOST | 韓國郵政 |
| 152 | POSTTH | 泰國郵政 |
| 153 | POSTSE | 瑞典郵政 |
總結
以上是生活随笔為你收集整理的如何对接快递助手物流查询接口【干货】的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 线性代数(9):线性正交
- 下一篇: 怎么用Canoe CAPL发送诊断