快递即时查询api接口功能详解攻略

网友投稿 849 2022-05-30

快递鸟即时查询api接口功能详解攻略

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)

API

版权声明:本文内容由网络用户投稿,版权归原作者所有,本站不拥有其著作权,亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容,请联系我们jiasou666@gmail.com 处理,核实后本网站将在24小时内删除侵权内容。

上一篇:Java IO知识点
下一篇:【案例分享】MapReduce Service OMS频繁主备倒换manager界面异常
相关文章