快遞物流評(píng)價(jià)接口A(yíng)PI文檔(附demo)

1、快遞物流評(píng)價(jià)接口A(yíng)PI文檔（附demo）物流評(píng)價(jià)接口是面向電商、ERP系統(tǒng)商、倉(cāng)儲(chǔ)系統(tǒng)商等企業(yè)，提供評(píng)價(jià)物流，網(wǎng)點(diǎn)，快遞員的渠道，并批量獲取平均分的功能，平均分值可應(yīng)用于快遞公司推薦排序，綜合選擇，展示商家實(shí)力等場(chǎng)景。商家的評(píng)價(jià)分值將由接口匯總計(jì)算，統(tǒng)一傳遞到物流公司，指導(dǎo)物流公司提升服務(wù)質(zhì)量。該接口由快遞鳥(niǎo)提供，分為評(píng)價(jià)接口和評(píng)分獲取接口。一、物流評(píng)價(jià)投訴接口1.接口描述/說(shuō)明通過(guò)此接口可對(duì)快遞公司、網(wǎng)點(diǎn)、快遞員進(jìn)行評(píng)價(jià)或投訴。（1）僅支持Json格式。（2）請(qǐng)求指令1011。（3）每次請(qǐng)求不超過(guò)100條明細(xì)。（4）測(cè)試接口地址：http:/testapi.kdniao.cc:8081/ap

2、i/dist（5）聯(lián)調(diào)通過(guò)后請(qǐng)更換為正式地址：http:/api.kdniao.cc/api/dist（6）需在快遞鳥(niǎo)網(wǎng)站申請(qǐng)接口秘鑰2.請(qǐng)求系統(tǒng)級(jí)參數(shù)說(shuō)明參數(shù)名稱(chēng)類(lèi)型說(shuō)明必須要求RequestDataString請(qǐng)求內(nèi)容需進(jìn)行URL(utf-8)編碼。請(qǐng)求內(nèi)容JSON格式，須和DataType一致。REBusinessIDString電商ID。RRequestTypeString請(qǐng)求指令類(lèi)型：1011RDataSignString數(shù)據(jù)內(nèi)容簽名RDataTypeString請(qǐng)求、返回?cái)?shù)據(jù)類(lèi)型：2-json；O3.應(yīng)用級(jí)參數(shù)參數(shù)名稱(chēng)類(lèi)型說(shuō)明必須要求MemberIDString會(huì)員IDOEvalu

3、ateTypeInt評(píng)價(jià)類(lèi)型(1-物流評(píng)價(jià)2-物流投訴)RExpressNodeInt物流環(huán)節(jié)(1-攬件 2-派件)ROrderCodeString訂單編號(hào)OLogisticCodeString物流單號(hào)RTargetExpCodeString快遞公司編碼ROutletCodeString網(wǎng)點(diǎn)編碼OCourierCodeString快遞員編碼OScoreExpValueDouble快遞公司分值COutletValueDouble快遞網(wǎng)點(diǎn)分值CCourierValueDouble快遞員分值CEvaluationTagString評(píng)價(jià)標(biāo)簽OContentsString內(nèi)容C備注：R-必填（Requi

4、red），O-可選（Optional），C-報(bào)文中該參數(shù)在一定條件下可選（Conditional）4.返回參數(shù)定義參數(shù)名稱(chēng)類(lèi)型說(shuō)明必須要求EBusinessIDString電商用戶(hù)IDRSuccessBool成功與否:true,falseRReasonString失敗原因O5.JSON請(qǐng)求示請(qǐng)求示例 JSON MemberID:, EvaluateType:1, ExpressNode:1, OrderCode:, LogisticCode:12345678, Target: ExpCode:YTO, OutletCode:0453, CourierCode:2001158001 , Scor

5、e: ExpValue:5, OutletValue:4.5, CourierValue:4 , EvaluationTag:速度快，服務(wù)好, Content: 6.JSON返回示例返回示例 JSON EBusinessID: 1261737, Success: true 二、物流平均分獲取接口1.接口描述/說(shuō)明通過(guò)此接口可以獲取各個(gè)快遞公司的評(píng)價(jià)平均分。（1）僅支持Json格式。（2）請(qǐng)求指令1012。（3）測(cè)試接口地址：http:/testapi.kdniao.cc:8081/api/dist（4）聯(lián)調(diào)通過(guò)后請(qǐng)更換為正式地址：http:/api.kdniao.cc/api/dist（5）需

6、申請(qǐng)秘鑰2.請(qǐng)求系統(tǒng)級(jí)參數(shù)說(shuō)明參數(shù)名稱(chēng)類(lèi)型說(shuō)明必須要求RequestDataString請(qǐng)求內(nèi)容，JSON,須和DataType一致。REBusinessIDString電商ID。RRequestTypeString請(qǐng)求指令類(lèi)型：1012RDataSignString數(shù)據(jù)內(nèi)容簽名RDataTypeString請(qǐng)求、返回?cái)?shù)據(jù)類(lèi)型：2-json；R3.應(yīng)用級(jí)參數(shù)參數(shù)名稱(chēng)類(lèi)型說(shuō)明必須要求MemberIDString會(huì)員IDOLogisticsTypeInt獲取類(lèi)型（1-物流公司2-快遞網(wǎng)點(diǎn)3-快遞員）RExpCodeInt快遞公司編碼OOrderCodeString網(wǎng)點(diǎn)編碼O備注：R-必填（Requ

7、ired），O-可選（Optional），C-報(bào)文中該參數(shù)在一定條件下可選（Conditional）4.返回參數(shù)定義參數(shù)名稱(chēng)類(lèi)型說(shuō)明必須要求EBusinessIDString電商用戶(hù)IDRSuccessBool成功與否:true,falseRScoresExpCodeString快遞公司編碼OExpValueDouble快遞公司分值OReasonString失敗原因O5.JSON請(qǐng)求示例請(qǐng)求示例 JSON MemberID:123456, LogisticsType:1, ExpCode:, OutletCode: 6.JSON返回示例返回示例 JSON EBusinessID: 126173

8、7, Success: true, Scores: ExpCode:EMS, ExpValue:4.3 , ExpCode:YTO, ExpValue:4.5 , ExpCode:SF, ExpValue:4.4 三、接口代碼1.PHP語(yǔ)言 EBusinessID, RequestType = 1011, RequestData = urlencode($requestData) , DataType = 2, ); $datasDataSign = encrypt($requestData, AppKey);$result=sendPost(ReqURL, $datas);/根據(jù)公司業(yè)務(wù)處理

9、返回的信息.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, Ap

10、pKey);$result=sendPost(ReqURL, $datas);/根據(jù)公司業(yè)務(wù)處理返回的信息.return $result; /* * post提交數(shù)據(jù) * param string $url 請(qǐng)求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 = imp

11、lode(&, $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; $h

12、ttpheader.= 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); re

13、turn $gets;/* * 電商Sign簽名生成 * param data 內(nèi)容 * param appkey Appkey * return DataSign簽名 */function encrypt($data, $appkey) return urlencode(base64_encode(md5($data.$appkey);?2.NET語(yǔ)言u(píng)sing System;using System.Collections.Generic;using System.Linq;using System.Text;using System.Web;using System.Net;using

14、System.IO; namespace KdGoldAPI public class KdApiSearchDemo /電商ID private string EBusinessID = 請(qǐng)申請(qǐng); /電商加密私鑰，注意保管，不要泄漏 private string AppKey = 請(qǐng)申請(qǐng); /請(qǐng)求url /測(cè)試環(huán)境 private string ReqURL = http:/testapi.kdniao.cc:8081/Ebusiness/EbusinessOrderHandle.aspx; /正式環(huán)境 /private string ReqURL = http:/api.kdniao.cc

15、/Ebusiness/EbusinessOrderHandle.aspx; / / Json方式 物流評(píng)價(jià)投訴 / / public string getExpEvaluateByJson() string requestData = MemberID: , + EvaluateType:1, + ExpressNode:1, + OrderCode:, + LogisticCode:12345678, + Target: + + ExpCode:YTO,OutletCode:0453,CourierCode:200115887318, + Score: + + ExpValue:5,Outl

16、etValue: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); pa

17、ram.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:; Dict

18、ionary 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); par

19、am.Add(DataType, 2); string result = sendPost(ReqURL, param); /根據(jù)公司業(yè)務(wù)處理返回的信息. return result; / / Post方式提交數(shù)據(jù)，返回網(wǎng)頁(yè)的源代碼 / / 發(fā)送請(qǐng)求的 URL / 請(qǐng)求的參數(shù)集合 / 遠(yuǎn)程資源的響應(yīng)結(jié)果 private string sendPost(string url, Dictionary param) string result = ; StringBuilder postData = new StringBuilder(); if (param != null & param.Cou

20、nt 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.Conte

21、ntType = 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 =

22、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

23、= 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