快递鸟即时查询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)