由于自己网站需要对接一些物流查询快递,然后在网上搜了一圈发现快递鸟比较适合我
之前写快递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地址免费调用
1、登录快递鸟官网注册页面注册快递鸟账号
2、登录快递鸟用户管理后台
注:登录快递鸟用户管理后台后获得用户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)