快遞物流評價接口API文檔(附demo).doc

快遞物流評價接口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