快递鸟即时查询api接口功能详解攻略
【摘要】 (一)接入流程:1>.注册快递鸟账号, API_ID:XXXXXX API_KEY:XXXXXXXXXXXXXXXXXX2>.服务申请 在个人中心里面申请需要的服务,即时查询功能有免费的服务3>.对接服务 ***写自己的业务逻辑***----本文主体4>.测试代码5>.正式使用(二)、接口描述/说明(1)查询接口支持按照运单号查询(单个查询)。(2)接口需要指定快递单...
(一)接入流程:
1>.注册快递鸟账号,
API_ID:XXXXXX
API_KEY:XXXXXXXXXXXXXXXXXX
2>.服务申请
在个人中心里面申请需要的服务,即时查询功能有免费的服务
3>.对接服务
***写自己的业务逻辑***----本文主体
4>.测试代码
5>.正式使用
(二)、接口描述/说明
(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)编码
先上图,看结果:
技术文档请参考快递鸟官网api:https://www.kdniao.com/api-track
快递公司编码链接:https://www.kdniao.com/file/2019快递鸟接口支持快递公司编码.xlsx
(四)功能封装
*省去了导包语句,根据自己情况添加
# 请求数据处理
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
视图逻辑:
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)
【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱:
cloudbbs@huaweicloud.com
- 点赞
- 收藏
- 关注作者
作者其他文章
评论(0)