免费对接快递鸟api单号识别查询接口demo案例 [复制链接]

2019-9-17 18:31
fire70 阅读:94 评论:0 赞:0
Tag:  
快递查询接口是指快递查询网对外开放的应用程序接口,开发人员能够通过调用该接口与快递查询网进行交互,并基于该接口开发自己的快递查询应用程序。
(一)接入流程:

1、登录快递鸟官网注册页面注册快递鸟账号


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
(三)必传参数说明:

[代码]java代码:

# 请求数据处理
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


我来说两句
您需要登录后才可以评论 登录 | 立即注册
facelist
所有评论(0)

领先的中文移动开发者社区
18620764416
7*24全天服务
意见反馈:1294855032@qq.com

扫一扫关注我们

Powered by Discuz! X3.2© 2001-2019 Comsenz Inc.( 粤ICP备15117877号 )