資源描述:
《快遞物流評價接口API文檔(附demo).doc》由會員上傳分享,免費在線閱讀,更多相關(guān)內(nèi)容在教育資源-天天文庫。
1、.快遞物流評價接口API文檔(附demo)物流評價接口是面向電商、ERP系統(tǒng)商、倉儲系統(tǒng)商等企業(yè),提供評價物流,網(wǎng)點,快遞員的渠道,并批量獲取平均分的功能,平均分值可應(yīng)用于快遞公司推薦排序,綜合選擇,展示商家實力等場景。商家的評價分值將由接口匯總計算,統(tǒng)一傳遞到物流公司,指導(dǎo)物流公司提升服務(wù)質(zhì)量。該接口由快遞鳥提供,分為評價接口和評分獲取接口。一、物流評價投訴接口1.接口描述/說明通過此接口可對快遞公司、網(wǎng)點、快遞員進行評價或投訴。(1)僅支持Json格式。(2)請求指令1011。(3)每次請求不超過100條明細。(4)測試接口地址:testapi.kdniao.cc:8081/api/dis
2、t(5)聯(lián)調(diào)通過后請更換為正式地址:api.kdniao.cc/api/dist(6)需在快遞鳥申請接口秘鑰2.請求系統(tǒng)級參數(shù)說明參數(shù)名稱類型說明必須要求RequestDataString請求容需進行URL(utf-8)編碼。請求容JSON格式,須和DataType一致。REBusinessIDString電商ID。RRequestTypeString請求指令類型:1011RDataSignString數(shù)據(jù)容簽名RDataTypeString請求、返回數(shù)據(jù)類型:2-json;O3.應(yīng)用級參數(shù)..參數(shù)名稱類型說明必須要求MemberIDString會員IDOEvaluateTypeInt評價類型
3、(1-物流評價2-物流投訴)RExpressNodeInt物流環(huán)節(jié)(1-攬件2-派件)ROrderCodeString訂單編號OLogisticCodeString物流單號RTargetExpCodeString快遞公司編碼ROutletCodeString網(wǎng)點編碼OCourierCodeString快遞員編碼OScoreExpValueDouble快遞公司分值COutletValueDouble快遞網(wǎng)點分值CCourierValueDouble快遞員分值CEvaluationTagString評價標簽OContentsString容C備注:R-必填(Required),O-可選(Option
4、al),C-報文中該參數(shù)在一定條件下可選(Conditional)4.返回參數(shù)定義參數(shù)名稱類型說明必須要求EBusinessIDString電商用戶IDR..SuccessBool成功與否:true,falseRReasonString失敗原因O5.JSON請求示請求示例JSON{"MemberID":"","EvaluateType":1,"ExpressNode":1,"OrderCode":"","LogisticCode":"12345678","Target":{"ExpCode":"YTO","OutletCode":"0453","CourierCode":"2001158001
5、"},"Score":{"ExpValue":5,"OutletValue":4.5,"CourierValue":4},"EvaluationTag":"速度快,服務(wù)好","Content":""}6.JSON返回示例返回示例JSON{"EBusinessID":"1261737","Success":true}二、物流平均分獲取接口1.接口描述/說明通過此接口可以獲取各個快遞公司的評價平均分。(1)僅支持Json格式。..(2)請求指令1012。(3)測試接口地址:testapi.kdniao.cc:8081/api/dist(4)聯(lián)調(diào)通過后請更換為正式地址:api.kdniao.cc/a
6、pi/dist(5)需申請秘鑰2.請求系統(tǒng)級參數(shù)說明參數(shù)名稱類型說明必須要求RequestDataString請求容,JSON,須和DataType一致。REBusinessIDString電商ID。RRequestTypeString請求指令類型:1012RDataSignString數(shù)據(jù)容簽名RDataTypeString請求、返回數(shù)據(jù)類型:2-json;R3.應(yīng)用級參數(shù)參數(shù)名稱類型說明必須要求MemberIDString會員IDOLogisticsTypeInt獲取類型(1-物流公司2-快遞網(wǎng)點3-快遞員)RExpCodeInt快遞公司編碼OOrderCodeString網(wǎng)點編碼O備注:
7、R-必填(Required),O-可選(Optional),C-報文中該參數(shù)在一定條件下可選(Conditional)4.返回參數(shù)定義參數(shù)名稱類型說明必須要求EBusinessIDString電商用戶IDR..SuccessBool成功與否:true,falseRScoresExpCodeString快遞公司編碼OExpValueDouble快遞公司分值OReasonString失敗原因O5.JS