由于自己网站需要对接一些物流查询快递，然后在网上搜了一圈发现快递鸟比较适合我
之前写快递api的时候，官网上只有php和.net的示例，而我使用python封装的相关功能踩了许多坑，才搞出来，分享一下我的方法。
技术文档请参考快递鸟官网api：https://www.kdniao.com/api-track
快递公司编码链接：https://www.kdniao.com/file/2019快递鸟接口支持快递公司编码.xlsx
【接入流程】
1>.注册快递鸟账号， API_ID：XXXXXXX
API_KEY：XXXXXXXXXXXXXXXXXX
2>.服务申请 在个人中心里面申请需要的服务，即时查询功能有免费的服务
3>.对接服务 ***写自己的业务逻辑***----本文主体
4>.测试代码
5>.正式使用
快递鸟物流单号查询api接口demo地址免费调用
注：登录快递鸟用户管理后台后获得用户ID和APIKey，此用于保证应用来源的可靠性，避免应用伪造，被不法使用。
使用说明：
1.kdniao.php 不需要修改改任何东西
2.example.php 按照说明使用
3.如果有什么不清楚的地方，请到快递鸟的官网咨询
4对接示例
Demo由快递鸟写好，只需要下载就可以运行用上，（自己做简单的修改）
下面是下载Demo的网站，根据自己需要下载 www.kdniao.com/api-all
（三）必传参数说明：
请求内容： OrderCode：
订单编号—非必须 ShipperCode：快递公司编码—必须 LogisticCode：物流单号—必须 系统参数 RequestData：
将JSON格式请求内容进行URL(utf-8)编码； EBusinessID：API_ID； RequestType：1002； DataSign：
请求内容(未编码)+AppKey)进行MD5加密，然后Base64编码，最后 进行URL(utf-8)编码
（四）功能封装
*省去了导包语句，根据自己情况添加
# 请求数据处理 def organize_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%", "%") 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 # 请求内容(未编码) + 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的空格效果 */
（五）视图逻辑：
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，此处需处理取得的数据，以取得所需的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" else trace_resp context = { "ShipperCode": shipper_code, "LogisticCode": logistic_code, "kd_response":traces } return render(request, 'kd_trace.html', context)