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

简介: 之前写快递的时候,官网上只有php和.net的示例,而我使用python封装的相关功能踩了许多坑,才搞出来,分享一下我的方法。先上图,看结果:技术文档请参考快递鸟官网api:免费查询快递接口_100%安全保障_物流即时查询API-快递鸟快递公司编码链接:https://www.

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

目录
相关文章
|
2天前
|
JSON API 数据格式
详细介绍下PYTHON API的用法
详细介绍下PYTHON API的用法
|
4天前
|
缓存 API 数据库
构建高效Python Web应用:Flask框架与RESTful API设计原则
【5月更文挑战第20天】 在现代Web开发中,构建一个轻量级且高效的后端服务至关重要。本文将深入探讨如何使用Python的Flask框架结合RESTful API设计原则来创建可扩展和易于维护的Web应用程序。我们将通过分析Flask的核心特性,以及如何利用它来实现资源的合理划分、接口的版本控制和请求处理优化等,来指导读者打造高性能的API服务。文中不仅提供了理论指导,还包括了实践案例,旨在帮助开发者提升开发效率,并增强应用的稳定性和用户体验。
|
7天前
|
缓存 监控 API
利用Python构建高性能的Web API后端服务
随着微服务架构的普及和RESTful API的广泛应用,构建高性能、可扩展的Web API后端服务变得尤为重要。本文将探讨如何利用Python这一强大且灵活的语言,结合现代Web框架和工具,构建高效、可靠的Web API后端服务。我们将分析Python在Web开发中的优势,介绍常用的Web框架,并通过实际案例展示如何设计并实现高性能的API服务。
|
7天前
|
监控 安全 数据挖掘
Email 接口API有哪些?具体分析一下阿里云和AOK的优点
本文介绍了常见的Email接口API,如阿里云邮件推送、AOKSend、SendGrid、Mailgun和Amazon SES。阿里云API以其高稳定性和数据分析功能脱颖而出,支持批量发送和多语言;而AOKSend API以易于集成、高安全性和优秀客户支持为亮点。企业在选择时应考虑自身需求和预算,以优化邮件营销效果。
|
7天前
|
定位技术 API
Angular 调用导入百度地图API接口,2024春招BAT面试真题详解
Angular 调用导入百度地图API接口,2024春招BAT面试真题详解
|
8天前
|
JSON 安全 API
解锁淘宝商品评论API接口:电商数据分析的新视角
淘宝商品评论API接口是淘宝开放平台提供的一组API接口,允许开发者通过编程方式获取淘宝商品评论数据。这些接口可以获取到商品的详细信息、用户评论、评分等数据,为电商数据分析提供了丰富的素材。
|
8天前
|
缓存 负载均衡 安全
探索API接口开发(定制与开发接口)
在当今数字化、互联互通的时代,API(应用程序编程接口)已经成为连接不同软件、服务和应用的关键桥梁。API接口开发,作为软件架构和系统设计的重要组成部分,不仅影响着数据交换的效率,更决定了整个系统的灵活性和可扩展性。本文将深入探讨API接口开发的各个方面,包括其重要性、开发流程、最佳实践以及面临的挑战。
|
9天前
|
文字识别 API 开发工具
印刷文字识别产品使用合集之API接口无法调用如何解决
印刷文字识别(Optical Character Recognition, OCR)技术能够将图片、扫描文档或 PDF 中的印刷文字转化为可编辑和可搜索的数据。这项技术广泛应用于多个领域,以提高工作效率、促进信息数字化。以下是一些印刷文字识别产品使用的典型场景合集。
36 6
|
9天前
|
监控 供应链 数据挖掘
抖音电商新篇章:douyin.item_get API接口的深度应用
douyin.item_get接口最基本的应用就是获取商品的详细信息。商家可以通过输入商品的ID或链接,获取商品的标题、价格、图片、描述、规格等关键信息。这些信息对于商家来说至关重要,可以帮助他们了解商品的销售情况、竞争态势以及市场需求。
|
9天前
|
存储 缓存 监控
利用Python和Flask构建RESTful API的实战指南
在当今的软件开发中,RESTful API已成为前后端分离架构中的核心组件。本文将带你走进实战,通过Python的Flask框架,一步步构建出高效、安全的RESTful API。我们将从项目初始化、路由设置、数据验证、错误处理到API文档生成,全方位地探讨如何构建RESTful API,并给出一些实用的最佳实践和优化建议。