




免費預(yù)覽已結(jié)束,剩余8頁可下載查看
下載本文檔
版權(quán)說明:本文檔由用戶提供并上傳,收益歸屬內(nèi)容提供方,若內(nèi)容存在侵權(quán),請進行舉報或認領(lǐng)
文檔簡介
快遞物流評價接口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)測試接口地址:http:/testapi.kdniao.cc:8081/api/dist(5)聯(lián)調(diào)通過后請更換為正式地址:http:/api.kdniao.cc/api/dist(6)需在快遞鳥網(wǎng)站申請接口秘鑰2.請求系統(tǒng)級參數(shù)說明參數(shù)名稱類型說明必須要求RequestDataString請求內(nèi)容需進行URL(utf-8)編碼。請求內(nèi)容JSON格式,須和DataType一致。REBusinessIDString電商ID。RRequestTypeString請求指令類型:1011RDataSignString數(shù)據(jù)內(nèi)容簽名RDataTypeString請求、返回數(shù)據(jù)類型:2-json;O3.應(yīng)用級參數(shù)參數(shù)名稱類型說明必須要求MemberIDString會員IDOEvaluateTypeInt評價類型(1-物流評價2-物流投訴)RExpressNodeInt物流環(huán)節(jié)(1-攬件 2-派件)ROrderCodeString訂單編號OLogisticCodeString物流單號RTargetExpCodeString快遞公司編碼ROutletCodeString網(wǎng)點編碼OCourierCodeString快遞員編碼OScoreExpValueDouble快遞公司分值COutletValueDouble快遞網(wǎng)點分值CCourierValueDouble快遞員分值CEvaluationTagString評價標簽OContentsString內(nèi)容C備注:R-必填(Required),O-可選(Optional),C-報文中該參數(shù)在一定條件下可選(Conditional)4.返回參數(shù)定義參數(shù)名稱類型說明必須要求EBusinessIDString電商用戶IDRSuccessBool成功與否:true,falseRReasonString失敗原因O5.JSON請求示請求示例 JSON MemberID:, EvaluateType:1, ExpressNode:1, OrderCode:, LogisticCode:12345678, Target: ExpCode:YTO, OutletCode:0453, CourierCode:2001158001 , Score: ExpValue:5, OutletValue:4.5, CourierValue:4 , EvaluationTag:速度快,服務(wù)好, Content: 6.JSON返回示例返回示例 JSON EBusinessID: 1261737, Success: true 二、物流平均分獲取接口1.接口描述/說明通過此接口可以獲取各個快遞公司的評價平均分。(1)僅支持Json格式。(2)請求指令1012。(3)測試接口地址:http:/testapi.kdniao.cc:8081/api/dist(4)聯(lián)調(diào)通過后請更換為正式地址:http:/api.kdniao.cc/api/dist(5)需申請秘鑰2.請求系統(tǒng)級參數(shù)說明參數(shù)名稱類型說明必須要求RequestDataString請求內(nèi)容,JSON,須和DataType一致。REBusinessIDString電商ID。RRequestTypeString請求指令類型:1012RDataSignString數(shù)據(jù)內(nèi)容簽名RDataTypeString請求、返回數(shù)據(jù)類型:2-json;R3.應(yīng)用級參數(shù)參數(shù)名稱類型說明必須要求MemberIDString會員IDOLogisticsTypeInt獲取類型(1-物流公司2-快遞網(wǎng)點3-快遞員)RExpCodeInt快遞公司編碼OOrderCodeString網(wǎng)點編碼O備注:R-必填(Required),O-可選(Optional),C-報文中該參數(shù)在一定條件下可選(Conditional)4.返回參數(shù)定義參數(shù)名稱類型說明必須要求EBusinessIDString電商用戶IDRSuccessBool成功與否:true,falseRScoresExpCodeString快遞公司編碼OExpValueDouble快遞公司分值OReasonString失敗原因O5.JSON請求示例請求示例 JSON MemberID:123456, LogisticsType:1, ExpCode:, OutletCode: 6.JSON返回示例返回示例 JSON EBusinessID: 1261737, Success: true, Scores: ExpCode:EMS, ExpValue:4.3 , ExpCode:YTO, ExpValue:4.5 , ExpCode:SF, ExpValue:4.4 三、接口代碼1.PHP語言 EBusinessID, RequestType = 1011, RequestData = urlencode($requestData) , DataType = 2, ); $datasDataSign = encrypt($requestData, AppKey);$result=sendPost(ReqURL, $datas);/根據(jù)公司業(yè)務(wù)處理返回的信息.return $result;/* * Json方式 物流平均分獲取 */function getExpAverageByJson()$requestData=MemberID:123456,LogisticsType:1,ExpCode:,OutletCode:;$datas = array( EBusinessID = EBusinessID, RequestType = 1012, RequestData = urlencode($requestData) , DataType = 2, ); $datasDataSign = encrypt($requestData, AppKey);$result=sendPost(ReqURL, $datas);/根據(jù)公司業(yè)務(wù)處理返回的信息.return $result; /* * post提交數(shù)據(jù) * param string $url 請求Url * param array $datas 提交的數(shù)據(jù) * return url響應(yīng)返回的html */function sendPost($url, $datas) $temps = array(); foreach ($datas as $key = $value) $temps = sprintf(%s=%s, $key, $value); $post_data = implode(&, $temps); $url_info = parse_url($url);if(empty($url_infoport)$url_infoport=80; $httpheader = POST . $url_infopath . HTTP/1.0rn; $httpheader.= Host: . $url_infohost . rn; $httpheader.= Content-Type:application/x-www-form-urlencodedrn; $httpheader.= Content-Length: . strlen($post_data) . rn; $httpheader.= Connection:closernrn; $httpheader.= $post_data; $fd = fsockopen($url_infohost, $url_infoport); fwrite($fd, $httpheader); $gets = ;$headerFlag = true;while (!feof($fd) if ($header = fgets($fd) & ($header = rn | $header = n) break; while (!feof($fd) $gets.= fread($fd, 128); fclose($fd); return $gets;/* * 電商Sign簽名生成 * param data 內(nèi)容 * param appkey Appkey * return DataSign簽名 */function encrypt($data, $appkey) return urlencode(base64_encode(md5($data.$appkey);?2.NET語言using System;using System.Collections.Generic;using System.Linq;using System.Text;using System.Web;using System.Net;using System.IO; namespace KdGoldAPI public class KdApiSearchDemo /電商ID private string EBusinessID = 請申請; /電商加密私鑰,注意保管,不要泄漏 private string AppKey = 請申請; /請求url /測試環(huán)境 private string ReqURL = http:/testapi.kdniao.cc:8081/Ebusiness/EbusinessOrderHandle.aspx; /正式環(huán)境 /private string ReqURL = http:/api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx; / / Json方式 物流評價投訴 / / public string getExpEvaluateByJson() string requestData = MemberID: , + EvaluateType:1, + ExpressNode:1, + OrderCode:, + LogisticCode:12345678, + Target: + + ExpCode:YTO,OutletCode:0453,CourierCode:200115887318, + Score: + + ExpValue:5,OutletValue:4.5,CourierValue:4, + EvaluationTag:速度快,服務(wù)好, + Content:; Dictionary param = new Dictionary(); param.Add(RequestData, HttpUtility.UrlEncode(requestData, Encoding.UTF8); param.Add(EBusinessID, EBusinessID); param.Add(RequestType, 1011); string dataSign = encrypt(requestData, AppKey, UTF-8); param.Add(DataSign, HttpUtility.UrlEncode(dataSign, Encoding.UTF8); param.Add(DataType, 2); string result = sendPost(ReqURL, param); /根據(jù)公司業(yè)務(wù)處理返回的信息. return result; / / Json方式 物流平均分獲取 / / public string getExpAverageByJson() string requestData = MemberID:123456,LogisticsType:1,ExpCode:,OutletCode:; Dictionary param = new Dictionary(); param.Add(RequestData, HttpUtility.UrlEncode(requestData, Encoding.UTF8); param.Add(EBusinessID, EBusinessID); param.Add(RequestType, 1012); string dataSign = encrypt(requestData, AppKey, UTF-8); param.Add(DataSign, HttpUtility.UrlEncode(dataSign, Encoding.UTF8); param.Add(DataType, 2); string result = sendPost(ReqURL, param); /根據(jù)公司業(yè)務(wù)處理返回的信息. return result; / / Post方式提交數(shù)據(jù),返回網(wǎng)頁的源代碼 / / 發(fā)送請求的 URL / 請求的參數(shù)集合 / 遠程資源的響應(yīng)結(jié)果 private string sendPost(string url, Dictionary param) string result = ; StringBuilder postData = new StringBuilder(); if (param != null & param.Count 0) foreach (var p in param) if (postData.Length 0) postData.Append(&); postData.Append(p.Key); postData.Append(=); postData.Append(p.Value); byte byteData = Encoding.GetEncoding(UTF-8).GetBytes(postData.ToString(); try HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url); request.ContentType = application/x-www-form-urlencoded; request.Referer = url; request.Accept = */*; request.Timeout = 30 * 1000; request.UserAgent = Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1; .NET CLR 2.0.50727; .NET CLR 3.0.04506.648; .NET CLR 3.0.4506.2152; .NET CLR 3.5.30729); request.Method = POST; request.ContentLength = byteData.Length; Stream stream = request.GetRequestStream(); stream.Write(byteData, 0, byteData.Length); stream.Flush(); stream.Close(); HttpWebResponse response = (HttpWebResponse)request.GetResponse(); Stream backStream = response.GetResponseStream(); StreamReader sr = new StreamReader(backStream, Encoding.GetEncoding(UTF-8); result = sr.ReadToEnd(); sr.Close(); backStream.Close(); response.Close(); request.Abort(); catch (Exception ex) result = ex.Message; return result; / /電商Sign簽名 / /內(nèi)容 /Appkey /URL編碼 /DataSign簽名 private string encrypt(String content, String keyValue, String charset) if (keyValue != null) return base64(MD5(content + keyValue
溫馨提示
- 1. 本站所有資源如無特殊說明,都需要本地電腦安裝OFFICE2007和PDF閱讀器。圖紙軟件為CAD,CAXA,PROE,UG,SolidWorks等.壓縮文件請下載最新的WinRAR軟件解壓。
- 2. 本站的文檔不包含任何第三方提供的附件圖紙等,如果需要附件,請聯(lián)系上傳者。文件的所有權(quán)益歸上傳用戶所有。
- 3. 本站RAR壓縮包中若帶圖紙,網(wǎng)頁內(nèi)容里面會有圖紙預(yù)覽,若沒有圖紙預(yù)覽就沒有圖紙。
- 4. 未經(jīng)權(quán)益所有人同意不得將文件中的內(nèi)容挪作商業(yè)或盈利用途。
- 5. 人人文庫網(wǎng)僅提供信息存儲空間,僅對用戶上傳內(nèi)容的表現(xiàn)方式做保護處理,對用戶上傳分享的文檔內(nèi)容本身不做任何修改或編輯,并不能對任何下載內(nèi)容負責。
- 6. 下載文件中如有侵權(quán)或不適當內(nèi)容,請與我們聯(lián)系,我們立即糾正。
- 7. 本站不保證下載資源的準確性、安全性和完整性, 同時也不承擔用戶因使用這些下載資源對自己和他人造成任何形式的傷害或損失。
最新文檔
- 高職院校美育課程建設(shè)中傳統(tǒng)文化融合的可行性研究
- 高校審計中大數(shù)據(jù)分析的使用與實踐探索
- 廣西壯族自治區(qū)北海市合浦縣2024年九年級化學第一學期期末質(zhì)量檢測模擬試題含解析
- 2025至2030短袖襯衫行業(yè)項目調(diào)研及市場前景預(yù)測評估報告
- 草莓采摘園與旅行社定制旅游服務(wù)合同
- 高溫高壓環(huán)境下的化工設(shè)備設(shè)計
- 2025年公職人員考試時事政治考試試題(附答案)
- 2025至2030巴基斯坦旋轉(zhuǎn)泵行業(yè)發(fā)展趨勢分析與未來投資戰(zhàn)略咨詢研究報告
- 2025至2030中國利瓦斯蒂明行業(yè)項目調(diào)研及市場前景預(yù)測評估報告
- 2025至2030中國自貿(mào)區(qū)(FTZ)行業(yè)現(xiàn)狀趨勢與發(fā)展前景戰(zhàn)略研究報告
- (完整版)曲臂式高空作業(yè)車安全技術(shù)交底
- 2024年民族宗教政策法規(guī)宣傳月知識競賽考試題庫(含答案)
- 《3-6歲兒童學習與發(fā)展指南》考試參考題庫120題(含答案)
- 診所中藥飲片清單
- 零信任安全架構(gòu)-第1篇
- 《發(fā)酵飼料的應(yīng)用》課件
- 國家開放大學2023年7月期末統(tǒng)一試《22417客戶關(guān)系管理》試題及答案-開放???/a>
- 西式面點師(高級)課件 項目4 甜品制作
- 鼎捷T100-V1.0-銷售管理用戶手冊-簡體
- 抗生素的合理應(yīng)用-專業(yè)知識講座培訓課件
- “三高共管、六病同防”工作實踐10-40-16
評論
0/150
提交評論