技术文档请参考快递鸟官网api：免费查询快递接口_100%安全保障_物流即时查询API-快递鸟
快递公司编码链接：https://www.kdniao.com/file/2019快递鸟接口支持快递公司编码.xlsx
（一）接入流程：
1、登录快递鸟官网注册页面注册快递鸟账号
网址：快递单号查询接口_电子面单_APIKey授权申请-快递鸟账号注册
2、登录快递鸟用户管理后台
注：登录快递鸟用户管理后台后获得用户ID和APIKey，此用于保证应用来源的可靠性，避免应用伪造，被不法使用。
3、进入“我的会员中心”进行实名认证
注：
3.1、认证类型、应用类型根据用户实际情况选择即可，接口返回数据与选择结果无关；
3.2、标记为*的为必填，要求上传清晰、jpg格式且小于2M的证件图片；
3.3、技术对接人信息为用户方对接工程师的信息；
3.4、如有其他疑问可进入官网加入商务合作群进行咨询。
认证成功后，进入“产品服务管理”，开通相关会员服务
（二）、接口描述/说明
（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
（三）必传参数说明：
请求示例：
# 请求数据处理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_datadef 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 |
