極兔速遞電子面單API接口C#

前言

J&T 極兔速遞是一家科技創新型互聯網快遞物流企業，致力于爲用戶帶來優質的快遞和物流體驗。

2015年8月由印尼首都雅加達作爲起點，進入快遞物流市場，目前覆蓋了印度尼西亞、越南、馬來西亞、泰國、菲律賓、柬埔寨及新加坡七個國家，成爲東南亞超過5.5億人口信賴的綜合性物流服務商。

電子面單模板效果圖：

電子面單打印模板規格列表：

快遞公司名稱編碼模板樣式尺寸規格TemplateSize字段CustomArea字段極兔速遞JTSD一聯130寬76**m**m 高130mm傳值130支持極兔速遞JTSD二聯180寬100**m**m 高180mm 切點110/70默認返回，不能傳值–

1.完成前期准備工作

1.1,去快遞鳥免費注冊一個對接賬號

1.2,免費獲得一個apiKey(接口權限驗證需要)

1.3,完成實名認證流程

1.4,訂購一個免費套餐

1.5,准備打印機、打印紙

打印機：電子面單模板對打印機品牌、型號等沒有要求，只要是熱敏打印機即可，常見品牌如：斑馬、得力、快麥、漢印、佳博等。

打印機可由快遞網點提供或者在淘寶京東上購買，安裝打印機及驅動程序聯系打印機提供方；

打印紙：打印紙可由快遞網點提供或者在淘寶京東上購買，購買時可選擇全白熱敏紙。

2.API接口

2.1,測試調用地址：http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json

2.2,正式調用地址：http://api.kdniao.com/api/EOrderService

2.3,請求方式：POST

2.4,編碼格式(utf-8)：application/x-www-form-urlencoded;charset=utf-8

2.5,返回類型：JSON

2.6,調試頁面：http://kdniao.com/UserCenter/v2/SandBox/TrackQuery.aspx

2.7,調試工具：去調試（使用快遞鳥賬號登錄）

3.請求報文（示例）

{“PayType”: 1,”CustomerName”: “J0086030000″,”CustomerPwd”: “Jt888888″,”ExpType”: 1,”ShipperCode”: “JTSD”,”OrderCode”: “300008886539888”,”IsNotice”: 1,”IsReturnPrintTemplate”: 1,”Commodity”: [{“GoodsName”: “其他”,”Goodsquantity”: 1,”GoodsWeight”: 0}],”Sender”: {“Name”: “王寶劍”,”Mobile”: “13988888888”,”ProvinceName”: “北京市”,”CityName”: “北京市”,”ExpAreaName”: “西城區”,”Address”: “北京市西城區西直門南小街國英1號1020″},”Receiver”: {“Name”: “劉小刀”,”Mobile”: “18809999999”,”ProvinceName”: “廣東省”,”CityName”: “深圳市”,”ExpAreaName”: “福田區”,”Address”: “廣東省深圳市福田區華寶一號大廈”}}

4.成功返回報文（示例）

{Order={LogisticCode=JT0000131754417, PackageName=180 600-01 001, OrderCode=300008886539888, KDNOrderCode=KDN2005141650003168, SortingCode=180 600-01 001}, PrintTemplate=打印html內容, EBusinessID=1237100,UniquerRequestNumber=f3ba8bf3-cb4c-4f06-8aee-7fba1e0e8376, ResultCode=100, Reason=成功, Success=true}

5.失敗返回報文（示例）

{ “EBusinessID”: “1237100”, “ResultCode”: “106”, “Reason”: “該訂單號已下單成功”， “UniquerRequestNumber”:”5e66486b-8fbc-4131-b875-9b13d2ad1354″ }

6.分步講解（C#版本）

6.1，請求數據包結構

6.2,C#調用代碼示例

技術支持：QQ:510997342//電商IDstring eEBusinessID = “test1617571”; //電商加密私鑰，快遞鳥提供，注意保管，不要泄漏string appKey= “554343b2-7252-439b-b4eb-1af42c8f2175”; //請求urlstring reqURL = “http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json”;//請求指令 string reqType=”1007″;//2-json string dataType = “2”; //字符編碼采用UTF-8 string charset = “UTF-8”; //JSON字符串string string jsonStr = “json請求報文示例” ;//把(jsonStr+APIKey)進行MD5加密string md5Str=MD5(jsonStr + apiKey, charset);//把md5Str 進行Base64編碼string base64Str=base64(md5Str,charset);//進行URL編碼 (utf-8)string datasign = HttpUtility.UrlEncode(base64Str, charset); //請求報文參數 string postStr = “RequestType=reqType&EBusinessID= eEBusinessID&RequestData=jsonStr &DataSign= datasign&DataType=dataType”; //通訊協議使用Http協議Post請求方式返回軌迹數據string post = SendPost(reqURL, postStr);//獲取到的post數據就是快遞鳥返回的完整報文，接下來自己寫一個解析json的方法就能獲取到裏面的字段信息。

6.3,C#調用方法

///<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 = check.ComputeHash(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)); } /// <summary> /// Post方式提交數據，返回網頁的源代碼 /// </summary> /// <param name=”url”>發送請求的 URL</param> /// <param name=”postData”>請求報文參數</param> /// <returns>遠程資源的響應結果</returns> private string SendPost(string url, string postData) { string result = “”; 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.ToString(); } return result; }

7.極兔速遞電子面單打印模板內容（HTML）

複制以上HTML內容保存爲html格式的文件，可以查看模板效果。

8.關于簽名

快遞鳥和第三方電子商務公司系統進行對接，有一定的安全機制。采用 IP 認證加簽名的方式對接，具體方案如下：

防止數據被篡改在 POST 請求中會傳遞 5 個必須(R)參數 RequestData==數據內容(URL 編碼:UTF-8) EBusinessID==用戶 ID RequestType=請求指令類型 DataSign== 數據內容簽名：把(請求內容(未編碼)+ApiKey)進行 MD5 加密，然後 Base64 編碼，最後進行 URL(utf-8)編碼 DataType==2(返回數據類型爲 json) 注：DataSign 生成後，對方接收到數據後，以同樣的算法進行簽名(推送接口 RequestType 爲 101/102 不需要進行 URL 編碼)，生成摘要，對比兩者的摘要是否相同，如果不同，說明傳遞過程中發生數據篡改。調用接口的身份認證注冊成爲快遞鳥用戶後，會生成對應的用戶 ID 和 APIKey，用戶 ID 相當于用戶名，

国际

極兔速遞電子面單API接口C#

目錄

前言

電子面單模板效果圖：

電子面單打印模板規格列表：

1.完成前期准備工作

2.API接口

3.請求報文（示例）

4.成功返回報文（示例）

5.失敗返回報文（示例）

6.分步講解（C#版本）

7.極兔速遞電子面單打印模板內容（HTML）

8.關于簽名

相關文章:

發佈留言取消回覆

目錄

前言

電子面單模板效果圖：

電子面單打印模板規格列表：

1.完成前期准備工作

2.API接口

3.請求報文（示例）

4.成功返回報文（示例）

5.失敗返回報文（示例）

6.分步講解（C#版本）

7.極兔速遞電子面單打印模板內容（HTML）

8.關于簽名

相關文章:

發佈留言 取消回覆

發佈留言取消回覆