技術(shù)文檔請參考快遞鳥官網(wǎng)api:免費(fèi)查詢快遞接口_100%安全保障_物流即時(shí)查詢API-快遞鳥
快遞公司編碼鏈接:https://www.kdniao.com/file/2019快遞鳥接口支持快遞公司編碼.xlsx
(一)接入流程:
1、登錄快遞鳥官網(wǎng)注冊頁面注冊快遞鳥賬號
網(wǎng)址:快遞單號查詢接口_電子面單_APIKey授權(quán)申請-快遞鳥賬號注冊
2、登錄快遞鳥用戶管理后臺
網(wǎng)址:用戶登錄_快遞鳥API讓物流接口對接更簡單
注:登錄快遞鳥用戶管理后臺后獲得用戶ID和APIKey,此用于保證應(yīng)用來源的可靠性,避免應(yīng)用偽造,被不法使用。
3、進(jìn)入“我的會(huì)員中心”進(jìn)行實(shí)名認(rèn)證
注:
3.1、認(rèn)證類型、應(yīng)用類型根據(jù)用戶實(shí)際情況選擇即可,接口返回?cái)?shù)據(jù)與選擇結(jié)果無關(guān);
3.2、標(biāo)記為*的為必填,要求上傳清晰、jpg格式且小于2M的證件圖片;
3.3、技術(shù)對接人信息為用戶方對接工程師的信息;
3.4、如有其他疑問可進(jìn)入官網(wǎng)加入商務(wù)合作群進(jìn)行咨詢。
認(rèn)證成功后,進(jìn)入“產(chǎn)品服務(wù)管理”,開通相關(guān)會(huì)員服務(wù)
注:
物流查詢(免費(fèi)版)會(huì)員套餐為免費(fèi)版,有效期1年結(jié)束后,如在近3個(gè)月內(nèi)有數(shù)據(jù)交互系統(tǒng)會(huì)自動(dòng)免費(fèi)續(xù)期;
(二)、接口描述/說明
(1)查詢接口支持按照運(yùn)單號查詢(單個(gè)查詢)。
(2)接口需要指定快遞單號的快遞公司編碼,格式不對或則編碼錯(cuò)誤都會(huì)返失敗的信息。
如:EMS物流單號應(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ù)說明:
# 請求數(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_datadef generate_data_sign(shipper_code, logistic_code):"""生成datasign"""original_request_data = {'OrderCode': '','ShipperCode': shipper_code,'LogisticCode': logistic_code,"IsHandleInfo": "0"}# APP_KEY = API_KEY_PROAPP_KEY = API_KEY_PRO# 請求內(nèi)容(未編碼) + AppKey# 此處有另一個(gè)坑,關(guān)于MD5加密,字典中存不存在空格,結(jié)果并不一樣,而對于此接口,需要去除空格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
/*MD5的空格效果 */
(五)視圖邏輯:
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ù),以取得所需的codeshipper_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_PROAPI_URL = API_URL_PROdata = {"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_respcontext = {"ShipperCode": shipper_code,"LogisticCode": logistic_code,"kd_response":traces}return render(request, 'kd_trace.html', context)
注:快遞鳥官網(wǎng)支持多種語言demo,更多demo可登錄快點(diǎn)鳥官網(wǎng)對接
總結(jié)
以上是生活随笔為你收集整理的python免费对接快递鸟api单号识别查询接口的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò),歡迎將生活随笔推薦給好友。