python免費對接快遞鳥api單號識別查詢接口

技術文檔請參考快遞鳥官網api：免費查詢快遞接口_100%安全保障_物流即時查詢API-快遞鳥

快遞公司編碼鏈接：https://www.kdniao.com/file/2019快遞鳥接口支持快遞公司編碼.xlsx
（一）接入流程：

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

（三）必傳參數說明：

# 請求數據處理
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)

注：快遞鳥官網支持多種語言demo，更多demo可登錄快點鳥官網對接