之前写快递的时候，官网上只有php和.net的示例，而我使用python封装的相关功能踩了许多坑，才搞出来，分享一下我的方法。
先上图，看结果：
技术文档请参考快递鸟官网api：免费查询快递接口_100%安全保障_物流即时查询API-快递鸟
快递公司编码链接：https://www.kdniao.com/file/2019快递鸟接口支持快递公司编码.xlsx
（一）接入流程：
1>.注册快递鸟账号，
API_ID：test1234567
API_KEY：XXXXXXXXXXXXXXXXXX2>.服务申请
在个人中心里面申请需要的服务，即时查询功能有免费的服务3>.对接服务
***写自己的业务逻辑***----本文主体4>.测试代码
5>.正式使用
1、登录快递鸟官网注册页面注册快递鸟账号
网址：快递单号查询接口_电子面单_APIKey授权申请-快递鸟账号注册
2、登录快递鸟用户管理后台
网址：用户登录_快递鸟API让物流接口对接更简单
注：登录快递鸟用户管理后台后获得用户ID和APIKey，此用于保证应用来源的可靠性，避免应用伪造，被不法使用。
3、进入“我的会员中心”进行实名认证
注：
3.1、认证类型、应用类型根据用户实际情况选择即可，接口返回数据与选择结果无关；
3.2、标记为*的为必填，要求上传清晰、jpg格式且小于2M的证件图片；
3.3、技术对接人信息为用户方对接工程师的信息；
3.4、如有其他疑问可进入官网加入商务合作群进行咨询。
认证成功后，进入“产品服务管理”，开通相关会员服务
注：
物流查询（免费版）会员套餐为免费版，有效期1年结束后，如在近3个月内有数据交互系统会自动免费续期；
（二）、接口描述/说明
（1）查询接口支持按照运单号查询(单个查询)。
（2）接口需要指定快递单号的快递公司编码，格式不对或则编码错误都会返失败的信息。
如：EMS物流单号应选择快递公司编码（EMS）查看快递公司编码
（3）返回的物流跟踪信息按照发生的时间升序排列。
（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
（三）必传参数说明：
请求内容：
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)
另外，python有快递鸟的第三方包，但是有些地方需要修改，而且看的有点晕，就自己写了一个用用，感觉更明白。若有不当之处，敬请斧正。
