您现在的位置是:首页 > 文章详情

快递鸟API单号查询接口功能之python

日期:2019-09-16点击:431

之前写快递的时候,官网上只有php和.net的示例,而我使用python封装的相关功能踩了许多坑,才搞出来,分享一下我的方法。
先上图,看结果:

技术文档请参考快递鸟官网api:免费查询快递接口_100%安全保障_物流即时查询API-快递鸟

快递公司编码链接:https://www.kdniao.com/file/2019快递鸟接口支持快递公司编码.xlsx

(一)接入流程:

1>.注册快递鸟账号,

API_ID:test1234567 API_KEY:XXXXXXXXXXXXXXXXXX

2>.服务申请

在个人中心里面申请需要的服务,即时查询功能有免费的服务

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有快递鸟的第三方包,但是有些地方需要修改,而且看的有点晕,就自己写了一个用用,感觉更明白。若有不当之处,敬请斧正。

原文链接:https://yq.aliyun.com/articles/718534
关注公众号

低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。

持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。

转载内容版权归作者及来源网站所有,本站原创内容转载请注明来源。

文章评论

共有0条评论来说两句吧...

文章二维码

扫描即可查看该文章

点击排行

推荐阅读

最新文章