《2017快递鸟物流评价接口API接入代码》由会员分享，可在线阅读，更多相关《2017快递鸟物流评价接口API接入代码（11页珍藏版）》请在金锄头文库上搜索。
1、2017快递鸟物流评价接口 API接入代码物流评价接口是面向电商、ERP系统商、仓储系统商等企业，提供评价物流，网点，快递 员的渠道，并批量获取平均分的功能，平均分值可应用于快递公司推荐排序，综合选择，展示商 家实力等场景。商家的评价分值将由接口汇总计算，统一传递到物流公司，指导物流公司提升服 务质量。一、物流评价投诉接口1. 接口描述/说明 通过此接口可对快递公司、网点、快递员进行评价或投诉。(1)仅支持Json格式。( 2)请求指令 1011。( 3 )每次请求不超过100 条明细。(4 )测试接口地址：http:/testapi.kdniao.cc:8081/api/dist( 5)联调
2、通过后请更换为正式地址： http:/api.kdniao.cc/api/dist( 6)需在快递鸟网站申请接口秘钥2. 请求系统级参数说明参数名称类型说明必须要求RequestDataString请求内容需进行URL(utf-8)编码。请求内容JSON格 式，须和DataType 致。REBusinessIDString电商ID。RRequestTypeString请求指令类型：1011RDataSignString数据内容签名RDataTypeString请求、返回数据类型：2-json ;O3.应用级参数备注：R-必填(Required ), 0-可选(Optional ), C-报文中
3、该参数在一定条件下可选(Conditional )4.返回参数定义参数名称类型说明必须要求EBusinessIDString电商用户IDRSuccessBool成功与否:true,falseRReasonString失败原因O5. JSON请求示请求示例JSONMemberlD:,EvaluateType:1,ExpressNode:1,OrderCode:,LogisticCode:12345678,Target:ExpCode:YTO, OutletCode:0453, CourierCode:2001158001,Score:ExpValue:5,OutletValue:4.5,Cour
4、ierValue:4,EvaluationTag:速度快，服务好,Content:6. JSON 返回示例二、物流平均分获取接口1.接口描述/说明 通过此接口可以获取各个快递公司的评价平均分。(1)仅支持Json格式。( 2)请求指令 1012。(3 )测试接口地址:http:/testapi.kdniao.cc:8081/api/dist( 4)联调通过后请更换为正式地址： http:/api.kdniao.cc/api/dist( 5 )需申请秘钥2.请求系统级参数说明参数名称类型说明必须要求RequestDataString请求内容，JSON,须和DataType 致。REBusines
5、sIDString电商ID。RRequestTypeString请求指令类型：1012RDataSignString数据内容签名RDataTypeString请求、返回数据类型：2-json ;R3.应用级参数参数名称类型说明必须要求MemberIDString会员IDOLogisticsTypeInt获取类型(1-物流公司2-快递网点3-快递员)RExpCodeInt快递公司编码OOrderCodeString网点编码O备注：R-必填(Required ), 0-可选(Optional ), C-报文中该参数在一定条件下可选(Conditional )4.返回参数定义5.JSON请求示例请求
6、示例JSONMemberID:123456,LogisticsType:1,ExpCode:,OutletCode:6.JSON 返回示例三、接口代码1.JAVA语言import java.io.BufferedReader;import java.io.IOException;import java.io.InputStreamReader;import java.io.OutputStreamWriter;import java.io.UnsupportedEncodingException;import java.ne t.HttpURLConnection;import java.ne
7、 t.URL;import java.ne t.URLEncoder;import java.security.MessageDigest;import java.util.HashMap;import java.util.Map;public class KdApiEvaluateDemo /DEMO public static void main(String args) KdApiEvaluateDemo api = new KdApiEvaluateDemo。;try String result = api.getEvaluateByJson();System.out.print(re
8、sult); catch (Exception e) e.printStackTrace();电商IDprivate String EBusinessID=电商加密私钥，注意保管，不要泄漏private String AppKey=;请求urlprivate String ReqURL=http:/api.kdniao.cc/Ebusiness/EbusinessOrderHandle.aspx;/* Json方式物流评价投诉* throws Exception*/public String getEvaluateByJson() throws ExceptionString requestD
9、ata= MemberlD: +EvaluateType:1, + ExpressNode:1, + OrderCode:, +LogisticCode:12345678, +Target: + +Score: + +EvaluationTag:速度Content:;ExpCode:YTO,OutletCode:O453,CourierCode:2OO115887318, +ExpValue:5,OutletValue:4.5,CourierValue:4, +快，服务好,+MapString, Stringparams = new HashMap(); params.put(RequestD
10、ata, urlEncoder(requestData, UTF-8); params.put(EBusinessID, EBusinessID); params.put(RequestType, 1011);String dataSign=encrypt(requestData, AppKey, UTF-8); params.put(DataSign, urlEncoder(dataSign, UTF-8); params.put(DataType, 2);String result=sendPost(ReqURL, params);根据公司业务处理返回的信息return result;*
11、Json方式物流平均分获取* throws Exception*/public String getAverageByJson() throws ExceptionString requestData=MemberID:123456,LogisticsType:1,ExpCode:,OutletCode:;MapString, Stringparams = new HashMap(); params.put(RequestData, urlEncoder(requestData, UTF-8); params.put(EBusinessID, EBusinessID);params.put(R
12、equestType, 1012);String dataSign=encrypt(requestData, AppKey, UTF-8); params.put(DataSign, urlEncoder(dataSign, UTF-8); params.put(DataType, 2);String result=sendPost(ReqURL, params);根据公司业务处理返回的信息.return result;/* MD5加密* param str 内容* param charset 编码方式* throws Exception*/SuppressWarnings(unused)pr
13、ivate String MD5(String str, String charset) throws Exception MessageDigest md = MessageDiges t. getInstance(MD5); md.update(str.getBytes(charset);byte result = md.digest();StringBuffer sb = new StringBuffer(32);for (int i = 0; i result .l ength; i+) int val = resulti & 0xff;if (val = 0xf) sb.append(0);sb.append(Integer.toHexString(val);return sb.toString().toLowerCase();/* base64 编码* param str 内容* param charset 编码方式* throws UnsupportedEncodingException*/ private String
