快遞鳥即時(shí)查詢api接口功能詳解攻略

1>.注冊快遞鳥賬號(hào)，

API_ID：XXXXXX

API_KEY：XXXXXXXXXXXXXXXXXX

2>.服務(wù)申請

在個(gè)人中心里面申請需要的服務(wù)，即時(shí)查詢功能有免費(fèi)的服務(wù)

3>.對(duì)接服務(wù)

***寫自己的業(yè)務(wù)邏輯***----本文主體

4>.測試代碼

5>.正式使用

（二）、接口描述/說明

（1）查詢接口支持按照運(yùn)單號(hào)查詢(單個(gè)查詢)。

（2）接口需要指定快遞單號(hào)的快遞公司編碼，格式不對(duì)或則編碼錯(cuò)誤都會(huì)返失敗的信息。

如：EMS物流單號(hào)應(yīng)選擇快遞公司編碼（EMS）查看快遞公司編碼

（3）返回的物流跟蹤信息按照發(fā)生的時(shí)間升序排列。

（4）接口指令1002。

（5）接口支持的消息接收方式為HTTP POST，請求方法的編碼格式(utf-8)：“application/x-www-form-urlencoded;charset=utf-8”。

（6）測試地址：http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json

（7）正式地址：http://api.kdniao.com/Ebusiness/EbusinessOrderHandle.aspx

（三）必傳參數(shù)說明：

請求內(nèi)容：

OrderCode：訂單編號(hào)—非必須

ShipperCode：快遞公司編碼—必須

LogisticCode：物流單號(hào)—必須

系統(tǒng)參數(shù)

RequestData：將JSON格式請求內(nèi)容進(jìn)行URL(utf-8)編碼；

EBusinessID：API_ID；

RequestType：1002；

DataSign：請求內(nèi)容(未編碼)+AppKey)進(jìn)行MD5加密，然后Base64編碼，最后 進(jìn)行URL(utf-8)編碼

先上圖，看結(jié)果：

技術(shù)文檔請參考快遞鳥官網(wǎng)api：https://www.kdniao.com/api-track

快遞公司編碼鏈接：https://www.kdniao.com/file/2019快遞鳥接口支持快遞公司編碼.xlsx

（四）功能封裝

*省去了導(dǎo)包語句，根據(jù)自己情況添加

#?請求數(shù)據(jù)處理 def?organize_request_data(shipper_code,?logistic_code):????"""編碼請求數(shù)據(jù)""" ????original_request_data?=?{????????"OrderCode":?"",??#?默認(rèn)設(shè)置為空????????"ShipperCode":?shipper_code,????????"LogisticCode":?logistic_code,????????"IsHandleInfo":?"0" ????} ????#?數(shù)據(jù)轉(zhuǎn)換為json格式 ????data?=?json.dumps(original_request_data) ???? ????#?進(jìn)行url編碼 ????#?這里有個(gè)坑，有興趣的可以試試 ????#??request_data?=?quote(data)，二者還是有區(qū)別的 ????request_data?=?quote(data).replace("%20%",?"%") ????return?request_data def?generate_data_sign(shipper_code,?logistic_code): """生成datasign""" ????original_request_data?=?{ ????????'OrderCode':?'', ????????'ShipperCode':?shipper_code, ????????'LogisticCode':?logistic_code,????????"IsHandleInfo":?"0" ????} ????#?APP_KEY?=?API_KEY_PRO ????APP_KEY?=?API_KEY_PRO ????#?請求內(nèi)容(未編碼)?+?AppKey ????#?此處有另一個(gè)坑，關(guān)于MD5加密，字典中存不存在空格，結(jié)果并不一樣，而對(duì)于此接口，需要去除空格 ????data?=?json.dumps(original_request_data).replace(":?",?":").replace(",?",?",")?+?APP_KEY ????#?md5加密 ????sign_md5?=?hashlib.md5(data.encode("utf-8")).hexdigest() ????#?Base64編碼 ????data_sign?=?base64.b64encode(sign_md5.encode("utf-8")).decode("utf-8") ????return?data_sign

視圖邏輯：

class?CompanyView(LoginRequiredView): ????"""快遞公司編碼展示""" ????def?get(self,?request): ????????company_qs?=?KDCompany.objects.all() ????????company_list?=?[]????????for?company?in?company_qs: ????????????company_list.append({????????????????"name":?company.name,????????????????"code":?company.code ????????????})????????return?http.JsonResponse({'code':?RETCODE.OK,?'errmsg':?'OK',?'company_list':?company_list})class?KD(LoginRequiredView): ????"""展示快遞詳情""" ????def?post(self,?request): ????????shipper_codes?=?request.POST.get('shipper_code')????????#?由于前端代碼的XX，此處需處理取得的數(shù)據(jù)，以取得所需的code ????????shipper_code=shipper_codes.split("?")[0] ????????logistic_code?=?request.POST.get('logistic_code') ????????request_data?=?organize_request_data(shipper_code,?logistic_code) ????????data_sign?=?generate_data_sign(shipper_code,?logistic_code) ????????API_ID?=?API_ID_PRO ????????API_URL?=?API_URL_PRO ????????data?=?{????????????"RequestData":?request_data,????????????"DataSign":?data_sign,????????????"RequestType":?"1002",????????????"EBusinessID":?API_ID,????????????"ShipperCode":?shipper_code,????????????"LogisticCode":?logistic_code,????????????"DataType":"2" ????????} #?按要求設(shè)置請求頭信息 ????????headers?=?{'content-type':?'application/x-www-form-urlencoded','content-Encoding':?'charset=utf-8'} ????????kd_response?=?requests.post(url=API_URL,?data=data,headers=headers) ????????kd_response.encoding="utf-8" ????????trace_resp=json.loads(kd_response.content).get("Traces") ????????trace_black?=?"" ????????traces?=?trace_black?if?type(trace_resp)?==?"NoneType"?else?trace_resp ????????context?=?{????????????"ShipperCode":?shipper_code,????????????"LogisticCode":?logistic_code,????????????"kd_response":traces ????????}????????return?render(request,?'kd_trace.html',?context)

API

版權(quán)聲明：本文內(nèi)容由網(wǎng)絡(luò)用戶投稿，版權(quán)歸原作者所有，本站不擁有其著作權(quán)，亦不承擔(dān)相應(yīng)法律責(zé)任。如果您發(fā)現(xiàn)本站中有涉嫌抄襲或描述失實(shí)的內(nèi)容，請聯(lián)系我們jiasou666@gmail.com 處理，核實(shí)后本網(wǎng)站將在24小時(shí)內(nèi)刪除侵權(quán)內(nèi)容。