C#对接各类免费快递api

C#对接各类免费快递api
1.1在线下单接口
1.1.1功能说明
在线下单接口是快递鸟提供给独立电商、仓储管理系统、物流供应链等物流系统平台使用的下单接口，为客户解决在线发货需求，客户通过网络选择快递公司发送请求通知贵公司有快递要发货，贵公司把数据通过此接口转发到快递鸟，由快递鸟为您提供通知快递员上门取件的服务。

1.1.2接口规则
(1)、订单编号(OrderCode)不可重复提交，重复提交系统会返回具体错误代码。

(2)、支持主流快递公司在线下单，请联系技术人员(联系方式请看文档尾部)。

(3)、接口只支持Json格式参数，接口指令1001。

只支持POST请求方式，utf-8编
码。

(4)、接口提供：快递鸟
(5)、支持增值服务，保价、代收货款、货款直退、货款垫付等。

(6)、测试地址：:8081/api/oorderservice/
正式地址：/api/oorderservice
1.1.3系统级输入参数
1.1.4应用级输入参数
1.1.5返回结果参数
1.1.6Json请求示例
1.1.7Json请求返回示例
1.2取消订单
1.2.1功能说明
物流公司还未指派业务员去取件的物流订单可进行取消操作，撤销时需用户填写原因，
填写后快递鸟会通知物流公司取消订单。

1.2.2接口规则
(1)、接口支持Json格式。

(2)、接口指令1004。

1.2.3系统级输入参数
1.2.4应用级输入参数
1.2.5返回结果参数
1.2.6JSON请求示例
1.2.7JSON返回示例
1.3电子面单
1.3.1功能说明
电子面单接口是快递鸟提供给独立电商、仓储管理系统、物流供应链等物流系统平台使用的下单接口，满足客户在线发货需求并提供打印面单的服务，客户通过网络选择物流公司发送请求通知贵公司有快递要发货，贵公司把数据通过此接口转发到快递鸟，由快递鸟为您通知对应的快递公司快递员上门取件。

电子面单成功下单后，快递鸟系统内将自动订阅，一旦轨迹发生变化时，快递鸟将调用客户方推送接收接口。

同时若客户使用代收货款服务，快递鸟会将代收货款的货款状态独立推送给用户。

1.3.2接口规则
(1)、只支持Json格式。

接口指令1007。

(2)、测试地址：:8081/api/eorderservice/
(3)、正式地址：/api/EOrderService
1.3.3系统级输入参数
1.3.4应用级输入参数
1.3.5返回结果参数
1.4增值服务列表
注：使用快递鸟代收货款服务，需申请快递鸟的代收货款服务，填写用于还款的银行卡号等信息。

1.5调用demo（PHP）
1.5.1电子面单demo
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using ;
using System.Text;
using System.Web;
namespace KdGoldAPI
{
/**
*
* 快递鸟电子面单接口
*
*
* ID和Key请到官网申请：/ServiceApply.aspx
*/
public class KdApiEOrderDemo
{
//电商ID
private string EBusinessID = "请到快递鸟官网申请/ServiceApply.aspx";
//电商加密私钥，快递鸟提供，注意保管，不要泄漏
private string AppKey = "请到快递鸟官网申请/ServiceApply.aspx";
//请求url, 正式环境地址：/api/Eorderservice
private string ReqURL = ":8081/api/EOrderService";
/// <summary>
/// Json方式电子面单
/// </summary>
/// <returns></returns>
public string orderTracesSubByJson()
{
string requestData = "{'OrderCode': '012657700312'," +
"'ShipperCode':'YTO'," +
"'PayType':1," +
"'ExpType':1," +
"'Cost':1.0," +
"'OtherCost':1.0," +
"'Sender':" +
"{" +
"'Company':'LV','Name':'Taylor','Mobile':'150****2396','ProvinceName':'上海','CityName':'上
海','ExpAreaName':'青浦区','Address':'明珠路73号'}," +
"'Receiver':" +
"{" +
"'Company':'GCCUI','Name':'Yann','Mobile':'150****2396','ProvinceName':'北京','CityName':'北
京','ExpAreaName':'朝阳区','Address':'三里屯街道雅秀大厦'}," +
"'Commodity':" +
"[{" +
"'GoodsName':'鞋子','Goodsquantity':1,'GoodsWeight':1.0}]," +
"'AddService':" +
"[{" +
"'Name':'COD','Value':'1020'}]," +
"'Weight':1.0," +
"'Quantity':1," +
"'Volume':0.0," +
"'Remark':'小心轻放'," +
"'IsReturnPrintTemplate':1}";
Dictionary<string, string> param = new Dictionary<string, string>();
param.Add("RequestData", HttpUtility.UrlEncode(requestData, Encoding.UTF8));
param.Add("EBusinessID", EBusinessID);
param.Add("RequestType", "1007");
string dataSign = encrypt(requestData, AppKey, "UTF-8");
param.Add("DataSign", HttpUtility.UrlEncode(dataSign, Encoding.UTF8));
param.Add("DataType", "2");
string result = sendPost(ReqURL, param);
//根据公司业务处理返回的信息......
return result;
}
/// <summary>
/// Post方式提交数据，返回网页的源代码
/// </summary>
/// <param name="url">发送请求的URL</param>
/// <param name="param">请求的参数集合</param>
/// <returns>远程资源的响应结果</returns>
private string sendPost(string url, Dictionary<string, string> 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;
erAgent = "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;
}
///<summary>
///电商Sign签名
///</summary>
///<param name="content">内容</param>
///<param name="keyValue">Appkey</param>
///<param name="charset">URL编码</param>
///<returns>DataSign签名</returns>
private string encrypt(String content, String keyValue, String charset)
{
if (keyValue != null)
return base64(MD5(content + keyValue, charset), charset);
}
return base64(MD5(content, charset), charset);
}
///<summary>
/// 字符串MD5加密
///</summary>
///<param name="str">要加密的字符串</param>
///<param name="charset">编码方式</param>
///<returns>密文</returns>
private string MD5(string str, string charset)
{
byte[] buffer = System.Text.Encoding.GetEncoding(charset).GetBytes(str);
try
{
System.Security.Cryptography.MD5CryptoServiceProvider check;
check = new System.Security.Cryptography.MD5CryptoServiceProvider();
byte[] somme = puteHash(buffer);
string ret = "";
foreach (byte a in somme)
{
if (a < 16)
ret += "0" + a.ToString("X");
else
ret += a.ToString("X");
}
return ret.ToLower();
}
catch
{
throw;
}
}
/// <summary>
/// base64编码
/// </summary>
/// <param name="str">内容</param>
/// <param name="charset">编码方式</param>
/// <returns></returns>
private string base64(String str, String charset)
{
return
Convert.ToBase64String(System.Text.Encoding.GetEncoding(charset).GetBytes(str));
}
}
}
1.5.2在线下单demo
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using ;
using System.IO;
using System.Web;
namespace KdGoldAPI
{
public class KdApiCreateOrderDemo
{
//电商ID
private string EBusinessID = "1237100";
//电商加密私钥，快递鸟提供，注意保管，不要泄漏
private string AppKey = "518a73d8-1f7f-441a-b644-33e77b49d846";
//请求url
private string ReqURL = "/Ebusiness/EbusinessOrderHandle.aspx";
/// <summary>
/// Json方式在线下单
/// </summary>
/// <returns></returns>
public string orderOnlineByJson()
{
string requestData = "{'LogisticsWeight':2.0," +
"'LogisticsVol':2.0," +
"'HQPOrderDesc':'尽快上门收件'," +
"'HQPPayType':1," +
"'IsNeedPay':2," +
"'Payment':121.0," +
"'OrderCode':'test_12345678905'," +
"'StartDate':'2015-05-13 21:20:53'," +
"'EndDate':'2015-05-14 21:20:53'," +
"'ShipperCode':'LB'," +
"'LogisticCode':'109932607391'," +
"'ToCompany':'华为科技'," +
"'ToName':'张三'," +
"'ToAddressArea':'深圳市南山区桂庙路555号'," +
"'ToTel':''," +
"'ToMobile':'138****0000',"+
"'OrderType':2," +
"'ToPostCode':'518128'," +
"'ToProvinceID':'广东省'," +
"'ToCityID':'深圳市'," +
"'ToExpAreaID':'南山区'," +
"'FromCompany':'小米科技'," +
"'FromName':'李四'," +
"'FromAddressArea':'深圳市福田区华强北路222号'," +
"'FromTel':'88888888'," +
"'FromMobile':''," +
"'FromPostCode':'529800'," +
"'FromProvinceID':'广东省'," +
"'FromCityID':'深圳市'," +
"'FromExpAreaID':'福田区'," +
"'Cost':21.0," +
"'OtherCost':2.0," +
"'Commoditys':" +
"[{" +
"'Goodsquantity':12," +
"'GoodsName':'手机屏幕'," +
"'GoodsCode':'kjyhu878787'," +
"'GoodsPrice':121.0," +
"}]}";
Dictionary<string, string> param = new Dictionary<string, string>();
param.Add("RequestData", HttpUtility.UrlEncode(requestData, Encoding.UTF8));
param.Add("EBusinessID", EBusinessID);
param.Add("RequestType", "1001");
string dataSign = encrypt(requestData, AppKey, "UTF-8");
param.Add("DataSign", HttpUtility.UrlEncode(dataSign, Encoding.UTF8));
param.Add("DataType", "2");
string result = sendPost(ReqURL, param);
//根据公司业务处理返回的信息......
return result;
}
/// <summary>
/// XML方式在线下单
/// </summary>
/// <returns></returns>
public string orderOnlineByXml()
{
string requestData = "<?xml version=\"1.0\" encoding=\"utf-8\" ?>" +
"<Content>" +
"<LogisticsWeight>1.5</LogisticsWeight>" +
"<OrderCode>test_1234567896</OrderCode>" +
"<LogisticsVol>0.5</LogisticsVol>" +
"<HQPOrderDesc>测试在线下单接口20150510</HQPOrderDesc>" +
"<HQPPayType>1</HQPPayType>" +
"<IsNeedPay>1</IsNeedPay>" +
"<Payment>1000</Payment>" +
"<OrderType>1</OrderType>" +
"<StartDate>2015-05-10 19:36:50</StartDate>" +
"<EndDate>2015-05-11 19:36:50</EndDate>" +
"<ShipperCode>LB</ShipperCode>" +
"<LogisticCode></LogisticCode>" +
"<ToName>张三</ToName>" +
"<ToAddressArea>深圳市南山区南新路2055号</ToAddressArea>" +
"<ToTel></ToTel>" +
"<ToMobile>138****0000</ToMobile>"+
"<ToPostCode></ToPostCode>" +
"<ToProvinceID>广东省</ToProvinceID>" +
"<ToCityID>深圳市</ToCityID>" +
"<ToExpAreaID>南山区</ToExpAreaID>" +
"<FromCompany>快递鸟科技</FromCompany>" +
"<FromName>李四</FromName>" +
"<FromAddressArea>深圳市福田区华强北路211号</FromAddressArea>" +
"<FromTel></FromTel>" +
"<FromMobile>138****8888</FromMobile>"+
"<FromPostCode></FromPostCode>" +
"<FromProvinceID>广东省</FromProvinceID>" +
"<FromCityID>深圳市</FromCityID>" +
"<FromExpAreaID>福田区</FromExpAreaID>" +
"<Cost>12</Cost>" +
"<OtherCost>1</OtherCost>" +
"<Commoditys>" +
"<Commodity>" +
"<GoodsName>惠普显示器</GoodsName>" +
"<GoodsCode>ABCD_123456789</GoodsCode>" +
"<Goodsquantity>2</Goodsquantity>" +
"<GoodsPrice>850</GoodsPrice>" +
"</Commodity>" +
"<Commodity>" +
"<GoodsName>神州笔记本</GoodsName>" +
"<GoodsCode>QWERT_456456</GoodsCode>" +
"<Goodsquantity>2</Goodsquantity>" +
"<GoodsPrice>4200</GoodsPrice>" +
"</Commodity>" +
"</Commoditys>" +
"</Content>";
Dictionary<string, string> param = new Dictionary<string, string>();
param.Add("RequestData", HttpUtility.UrlEncode(requestData, Encoding.UTF8));
param.Add("EBusinessID", EBusinessID);
param.Add("RequestType", "1001");
string dataSign = encrypt(requestData, AppKey, "UTF-8");
param.Add("DataSign", HttpUtility.UrlEncode(dataSign, Encoding.UTF8));
param.Add("DataType", "1");
string result = sendPost(ReqURL, param);
//根据公司业务处理返回的信息......
return result;
}
/// <summary>
/// Post方式提交数据，返回网页的源代码
/// </summary>
/// <param name="url">发送请求的URL</param>
/// <param name="param">请求的参数集合</param>
/// <returns>远程资源的响应结果</returns>
private string sendPost(string url, Dictionary<string, string> 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;
erAgent = "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;
}
///<summary>
///电商Sign签名
///<param name="content">内容</param>
///<param name="keyValue">Appkey</param>
///<param name="charset">URL编码</param>
///<returns>DataSign签名</returns>
private string encrypt(String content, String keyValue, String charset)
{
if (keyValue != null)
{
return base64(MD5(content + keyValue, charset), charset);
}
return base64(MD5(content, charset), charset);
}
///<summary>
/// 字符串MD5加密
///</summary>
///<param name="str">要加密的字符串</param>
///<param name="charset">编码方式</param>
///<returns>密文</returns>
private string MD5(string str, string charset)
{
byte[] buffer = System.Text.Encoding.GetEncoding(charset).GetBytes(str);
try
{
System.Security.Cryptography.MD5CryptoServiceProvider check;
check = new System.Security.Cryptography.MD5CryptoServiceProvider();
byte[] somme = puteHash(buffer);
string ret = "";
foreach (byte a in somme)
{
if (a < 16)
ret += "0" + a.ToString("X");
else
ret += a.ToString("X");
}
return ret.ToLower();
}
catch
{
throw;
}
}
/// base64编码
/// </summary>
/// <param name="str">内容</param>
/// <param name="charset">编码方式</param>
/// <returns></returns>
private string base64(String str, String charset)
{
return
Convert.ToBase64String(System.Text.Encoding.GetEncoding(charset).GetBytes(str));
}
}
}。