由于自己网站需要对接一些物流查询快递,然后在网上搜了一圈发现快递鸟比较适合我
之前写快递api的时候,官网上只有php和.net的示例,而我使用python封装的相关功能踩了许多坑,才搞出来,分享一下我的方法。
【接入流程】
1>.注册快递鸟账号,
API_ID:XXXXXXX
API_KEY:XXXXXXXXXXXXXXXXXX
2>.服务申请 在个人中心里面申请需要的服务,即时查询功能有免费的服务3>.对接服务***写自己的业务逻辑***----本文主体4>.测试代码5>.正式使用
快递鸟物流单号查询api接口demo地址免费调用
注:登录快递鸟用户管理后台后获得用户ID和APIKey,此用于保证应用来源的可靠性,避免应用伪造,被不法使用。
使用说明:
1.kdniao.php 不需要修改改任何东西
2.example.php 按照说明使用
3.如果有什么不清楚的地方,请到快递鸟的官网咨询
4对接示例
Demo由快递鸟写好,只需要下载就可以运行用上,(自己做简单的修改)
(三)必传参数说明:
请求内容: OrderCode:
订单编号—非必须 ShipperCode:快递公司编码—必须 LogisticCode:物流单号—必须 系统参数 RequestData:
将JSON格式请求内容进行URL(utf-8)编码; EBusinessID:API_ID; RequestType:1002; DataSign:
请求内容(未编码)+AppKey)进行MD5加密,然后Base64编码,最后 进行URL(utf-8)编码
(四)功能封装
*省去了导包语句,根据自己情况添加
#请求数据处理
deforganize_request_data(shipper_code, logistic_code):"""编码请求数据"""original_request_data={"OrderCode": "", #默认设置为空
"ShipperCode": shipper_code,"LogisticCode": logistic_code,"IsHandleInfo": "0"}#数据转换为json格式
data =json.dumps(original_request_data)#进行url编码
#这里有个坑,有兴趣的可以试试
#request_data = quote(data),二者还是有区别的
request_data = quote(data).replace("%20%", "%")returnrequest_datadefgenerate_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#请求内容(未编码) + AppKey
#此处有另一个坑,关于MD5加密,字典中存不存在空格,结果并不一样,而对于此接口,需要去除空格
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的空格效果 */
(五)视图逻辑:
classCompanyView(LoginRequiredView):"""快递公司编码展示"""
defget(self, request):
company_qs=KDCompany.objects.all()
company_list=[]for company incompany_qs:
company_list.append({"name": company.name,"code": company.code
})return http.JsonResponse({'code': RETCODE.OK, 'errmsg': 'OK', 'company_list': company_list})classKD(LoginRequiredView):"""展示快递详情"""
defpost(self, request):
shipper_codes= request.POST.get('shipper_code')#由于前端代码的XX,此处需处理取得的数据,以取得所需的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"}#按要求设置请求头信息
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" elsetrace_resp
context={"ShipperCode": shipper_code,"LogisticCode": logistic_code,"kd_response":traces
}return render(request, 'kd_trace.html', context)