主页 > 职业资格 > 速录师培训 >

快递单号查询接口对接C#教程.net源码「快递鸟API」

  • 推荐星级:
  • 授课对象:
  • 上课地址:
  • 授课学校:
  • 浏览人数:
课程价格:
  • 课程详情
  • 学校环境
  • 课程评价
本文摘要:零售电商平台及ISV商家对物流api接口的需求有许多,今天我们主要分享的就是快递鸟快递单号查询接口的对接指南,快递单号查询接口对接的应用场景有许多,许多场景会遇到,最主要的就是电商网站用户打开“我的订单”时挪用此API显示物流信息详情,电商治理后台的物流系统,客服在对账前查询所有运单的签收状态,并追踪问题,电商平台对商家物流管控,要求必须在多久快递必须发出要看到揽件状态,多久必须收到货物看到签收状态,凭据这些状态对商家管控从而提高用户的整体满足度。

pp电子官网

零售电商平台及ISV商家对物流api接口的需求有许多,今天我们主要分享的就是快递鸟快递单号查询接口的对接指南,快递单号查询接口对接的应用场景有许多,许多场景会遇到,最主要的就是电商网站用户打开“我的订单”时挪用此API显示物流信息详情,电商治理后台的物流系统,客服在对账前查询所有运单的签收状态,并追踪问题,电商平台对商家物流管控,要求必须在多久快递必须发出要看到揽件状态,多久必须收到货物看到签收状态,凭据这些状态对商家管控从而提高用户的整体满足度。挪用快递鸟快递单号查询API接口,就能查询到600家以上快递公司单号从收件、运输,到转运中心,派送到签收等各个环节的物流发货状态。

快递鸟api接口不区离开发语言,支持Java,C#,PHP,Python,ObjectC等开发语言的法式挪用。下面详细解说实现历程:对接使用流程1、将快递单号和快递公司编码发送給快递鸟2、快递鸟凭据单号和快递公司查询到物流轨迹状态3、快递鸟将查询到的物流轨迹状态反馈給电商平台或ISV服务商4、电商平台或ISV服务商吸收数据并实时处置惩罚做数据展示或应用接口形貌说明(1)查询接口支持根据运单号查询(单个查询)。(2)接口需要指定快递单号的快递公司编码,花样差池或则编码错误都市返失败的信息。

如:EMS物流单号应选择快递公司编码(EMS)检察下载快递鸟快递公司编码(3)返回的物流跟踪信息根据发生的时间升序排列。(4)接口指令1002。(5)接口支持的消息吸收方式为HTTP POST,请求方法的编码花样(utf-8):"application/x-www-form-urlencoded;charset=utf-8"。

(6)测试挪用地址:http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json (7)正式挪用地址:http://api.kdniao.com/api/dist(8)返回类型:JSON(9)调试页面:http://kdniao.com/UserCenter/v2/SandBox/TrackQuery.aspx(10)调试工具:去调试(使用快递鸟账号登录) 请求系统级参数说明:备注:R-必填(Required),O-可选(Optional),C-报文中该参数在一定条件下可选(Conditional)【接口参数】请求内容字段界说:返回参数界说:示例请求示例 JSON{ "OrderCode": "", "ShipperCode": "SF", "LogisticCode": "118650888018" }返回示例 JSON没有物流轨迹的 { "EBusinessID": "1109259", "Traces": [], "OrderCode": "", "ShipperCode": "SF", "LogisticCode": "118461988807", "Success": false, "Reason": null } 有物流轨迹的 { "EBusinessID": "1109259", "OrderCode": "", "ShipperCode": "SF", "LogisticCode": "118461988807", "Success": true, "State": 3, "Reason": null, "Traces": [ { "AcceptTime": "2014/06/25 08:05:37", "AcceptStation": "正在派件..(派件人:邓裕富,电话:18718866310)[深圳 市]", "Remark": null }, { "AcceptTime": "2014/06/25 04:01:28", "AcceptStation": "快件在 深圳集散中心 ,准备送往下一站 深圳 [深圳市]", "Remark": null }, { "AcceptTime": "2014/06/25 01:41:06", "AcceptStation": "快件在 深圳集散中心 [深圳市]", "Remark": null }, { "AcceptTime": "2014/06/24 20:18:58", "AcceptStation": "已收件[深圳市]", "Remark": null }, { "AcceptTime": "2014/06/24 20:55:28", "AcceptStation": "快件在 深圳 ,准备送往下一站 深圳集散中心 [深圳市]", "Remark": null }, { "AcceptTime": "2014/06/25 10:23:03", "AcceptStation": "派件已签收[深圳市]", "Remark": null }, { "AcceptTime": "2014/06/25 10:23:03", "AcceptStation": "签收人是:已签收[深圳市]", "Remark": null } ] }前期准备事情去快递鸟官网免费注册一个账号,免费获得一个apiKey(接口权限验证需要),完成实名认证流程,订购一个免费或付费套餐(也可找快递鸟事情人员免费申请付费的接口测试联调)快递鸟技术开发文档下载快递鸟DEMO下载注:登录快递鸟用户治理后台后获得用户ID和APIKey对应各demo中的EBusinessID、AppKey。小知识:EBusinessID跟APIKey是什么?EBusinessID跟APIKey您在快递鸟网站注册之后快递鸟分配的密钥(对应官网上的用户ID和API key),用于保证应用泉源的可靠性,制止应用伪造,被非法使用。请求完整报文(示例)RequestData=%7b%27OrderCode%27%3a%27%27%2c%27ShipperCode%27%3a%27JTSD%27%2c%27LogisticCode%27%3a%27jt0000052600488%27%7d&EBusinessID=1264783&RequestType=1002&DataSign=MTYyMDU4NWQ2NmU1ZDI2MDEzNGE5YmVlM2YxYzEzMTM%3d&DataType=2乐成返回报文(示例){"LogisticCode": "JT0000052600488","ShipperCode": "JTSD","Traces": [{"AcceptStation": "【芜湖市】【芜湖镜湖网点】的邓拥军 17855364213已取件","AcceptTime": "2020-03-16 16:26:13"},{"AcceptStation": "【芜湖市】【芜湖镜湖网点】的邓拥军 17855364213已取件","AcceptTime": "2020-03-16 16:41:33"},{"AcceptStation": "【芜湖市】【芜湖镜湖网点】已收件","AcceptTime": "2020-03-16 17:39:21"},{"AcceptStation": "【芜湖市】快件脱离【芜湖镜湖网点】已发往【芜湖转运中心】","AcceptTime": "2020-03-16 17:40:27"},{"AcceptStation": "【芜湖市】快件到达【芜湖转运中心】","AcceptTime": "2020-03-16 19:36:32"},{"AcceptStation": "【芜湖市】快件脱离【芜湖转运中心】已发往【合肥转运中心】","AcceptTime": "2020-03-16 20:47:03"},{"AcceptStation": "【合肥市】快件到达【合肥转运中心】","AcceptTime": "2020-03-16 23:40:10"},{"AcceptStation": "【合肥市】快件脱离【合肥转运中心】已发往【广州花都转运中心】","AcceptTime": "2020-03-17 00:10:48"},{"AcceptStation": "【广州市】快件到达【广州花都转运中心】","AcceptTime": "2020-03-17 20:45:00"},{"AcceptStation": "【广州市】快件脱离【广州花都转运中心】已发往【深圳宝安转运中心】","AcceptTime": "2020-03-18 00:17:55"},{"AcceptStation": "【深圳市】快件到达【深圳宝安转运中心】","AcceptTime": "2020-03-18 03:00:17"},{"AcceptStation": "【深圳市】快件脱离【深圳宝安转运中心】已发往【深圳福田网点】","AcceptTime": "2020-03-18 04:44:39"},{"AcceptStation": "【深圳市】【深圳福田网点】的邹俊林 17679495647正在派件","AcceptTime": "2020-03-18 08:10:09"},{"AcceptStation": "【深圳市】【深圳福田网点】的赵凯 15919817730正在派件","AcceptTime": "2020-03-18 09:55:19"},{"AcceptStation": "【深圳市】快件已签收,签收人是【代收】,如有疑问请联系:15919817730,期待再次为您服务","AcceptTime": "2020-03-18 14:53:54"}],"State": "3","EBusinessID": "1264783","Success": true}失败返回报文(示例){"LogisticCode": "JT0000052600488","ShipperCode": "JTSD","Traces": [],"State": "0","EBusinessID": "1264783","Reason": "业务错误[没有可用套餐]","Success": false}说明:未实名认证,未订购套餐,套餐可用查询量已经用完 都市返回此报文信息去实名认证/ 相识套餐详情无轨迹返回报文(示例){"LogisticCode": "JT0000052600488","ShipperCode": "JTSD","Traces": [],"State": "0","EBusinessID": "1264783","Reason": "暂无轨迹信息","Success": true}分步解说(C#版本)请求数据包结构C#挪用代码示例//电商IDstring eEBusinessID = "test1617571"; //电商加密私钥,快递鸟提供,注意保管,不要泄漏string appKey= "554343b2-7252-439b-b4eb-1af42c8f2175"; //请求urlstring reqURL = "http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json";//请求指令 string reqType="1002";//2-json string dataType = "2"; //字符编码接纳UTF-8 string charset = "UTF-8"; //JSON字符串string string jsonStr = "{"OrderCode":"","ShipperCode":"JTSD","LogisticCode":"JT0000052600488"}" ;//把(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的方法就能获取到内里的字段信息。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; }快递单号查询接口应用效果完成可以到达快递官网的显示效果。

关于签名快递鸟和第三方电子商务公司系统举行对接,有一定的宁静机制。接纳 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 相当于用户名, APIKey 相当于密码。

13.返回码界说14、关于沙箱调试在沙箱调试平台设置回调地址,测试推送接口。回调地址是用户提供,用于吸收快递鸟推送的物流信息的,只要是外网可以会见的就行。测试、设置步骤如下:(沙箱调试平台地址:http://kdniao.com/UserCenter/v2/SandBox/PushQueryParam.aspx)a、填写回调地址:b、点击【生成】后 应用级参数报文(RequestData)就是推送到用户第一步时填写的回调地址上的测试物流信息。

c、点击【挪用】,用户吸收到测试的物流信息后,用户需要在 应用级参数报文区域 返回乐成吸收的信号给快递鸟(注:字段间不要存在空格,空格会影响返回效果),返回花样:{"EBusinessID":"1237100","UpdateTime":"2015-03-11 16:26:11","Success":true,"Reason": ""} d、挪用效果显示为请求乐成后即用户开发的推送接口通过测试。e、测试通事后回到第一步填写回调地址的位置点击【设置】,弹出弹框,填写手机号(必须是注册快递鸟账号的手机号)、验证码、回调地址,点击【生存】设置乐成即可在正式情况使用,下次如果需要修改回调地址同初次设置回调地址步骤一致。对接中的其他说明1、物流查询(免费版)会员套餐为免费版,有效期1年竣事后,如在近3个月内有数据交互系统会自动免费续期;2、即时查询(RequestType:1002/8001)日查询次数<=3000次对接即时查询接口3、请求接口之前需要先实名认证,开通相关会员服务,否则会请求失败并返回提示“未申请开通接口”;4、接口开发可以下载“快递鸟接口技术文档”举行参考;即时查询,参考技术文档中的4.1或5.1.1部门;5、物流跟踪(RequestType:1008/8008)日查询次数>3000次对接物流跟踪接口6、测试订阅接口,对照技术文档正确返回代表订阅接口对接乐成,详情可见技术文档。7、开发推送接口,无demo提供,推送时会推送requestType、requestData和DataSign三个参数,您开发一个推送接口吸收这三个参数就行,乐成吸收后需要在5S内给快递鸟返回乐成收数据的报文,否则超时。

RequestData中包罗应用级参数,即物流轨迹(详情看技术文档);8、订阅接口、推送接口划分测试乐成后,可使用正式地址举行订阅真实的快递单号,快递鸟一般会在2-12小时内推送物流信息至您已经设置好的回调地址上;可能还体贴的问题解答1、问题:快递鸟接口有并发要求吗?快递鸟即时查询接口并发不凌驾10次/秒,物流跟踪接口订阅不凌驾30次/秒,电子面单接口下单不凌驾20次/秒。2、问题:快递鸟api收费尺度是什么?快递鸟查询接口和电子面单等接口有免费提供的,如果您对数据的状态时效、服务等有特此外需求,可联系快递鸟事情人员,为您量身定制专属解决方案,详细收费会凭据您的需求举行商定。3、问题:快递鸟数据更新实时性如何?即时查询接口:实时获取当前最新轨迹信息,数据与官网信息一致。物流跟踪接口:快递鸟每2小时到快递公司获取轨迹,如果您订阅的单号没有轨迹更新,距离2小时后再次到快递公司获取轨迹,依次循环直到有物流轨迹更新,获取到新轨迹后举行排队序列推送。

4、问题:快递鸟数据准确性,会不会存在物流状态禁绝确的问题?轨迹信息准确度大于99.9%。物流轨迹信息保持与快递公司官网一致,偶然存在快递公司提供的接口数据与官网纷歧致的情况,纷歧致情况小于0.1%。

5、问题:快递鸟即时查询接口和物流跟踪接口有什么区别?(1)接入方式纷歧样:即时查询接口,凭据快递单号和快递公司编码实时查询物流轨迹信息。物流跟踪接口,用户订阅快递号,快递鸟系统会定时推送新的物流信息。(2)实现的功效纷歧样:即时查询接口,单次请求只能查询一个单的物流信息,支持10次/S的并发请求。

物流跟踪接口,订阅推送的模式获取轨迹信息,提倡一次订阅后,快递鸟会连续监控推送更新的轨迹信息,直到签收。(3)查询单量纷歧样:即时查询逐日查询次数<=3000次,物流跟踪不限制订阅单量,并可一直获得每个单号的更新信息。6、问题: 快递鸟物流跟踪数据的时效性怎样?在吸收到新的快递单后,会立刻加入监控行列,有效果的话会即时内返回,没有效果的话,会等候一定时间(如2小时)再举行下一次监控。对于这些后续的监控,如果某运单号在快递公司官网对应的效果B,B最新一条状态所对应的时间为T1,快递鸟将B推送给贵公司的时间为T2,那么|T2-T1|一般在0~2~4 个小时以内,但我方会不停地向贵方举行推送,使运单状态能连续地更新。

7、问题:快递鸟物流跟踪是需要我们自己开发吸收接口是吗?对接物流跟踪接口,你需要开发订阅接口(将单号和快递公司编码订阅给快递鸟。有订阅接口的.net,php和java版本demo,你可以参考下。另有自己开发一个推送接口(吸收快递鸟推送的物流轨迹),开发完后登录快递鸟沙箱后台调试推送接口,调试乐成后可在沙箱后台自助设置推送接口。

8、问题:快递鸟物流跟踪的推送接口怎么做?推送接口是用于吸收推送的物流信息,推送接口是我们挪用你的接口,你只需要吸收参数,在沙箱后台设置你的回调地址就行,RequestData中包罗应用级参数,即物流轨迹,推送时会推送requestType、requestData和DataSign三个参数(详情看技术文档),您开发一个推送接口吸收这三个参数就行。9、问题:快递鸟的物流跟踪API实现原理是什么?订阅接口的事情原理是:用户将快递单号订阅给我们,我们马上加入行列去物流公司官方接口查询,查询有轨迹就给用户推送。如果没有更新数据,两个小时后会再次去物流公司官方接口查询,有新数据就将全量数据推送给用户,如果没有更新数据,两个小时后再重复上述行动,直到运单签收。

10、问题:快递鸟支持哪些快递物流公司查询接口?快递鸟支持600家以上快递物流公司的接口,详细在快递鸟官网下载《快递鸟接口支持快递公司编码.xlsx》检察。快递鸟是中国领先的物流信息服务商,国家高新技术企业,已先后完成四轮融资,一直专注于企业级物流API技术研发和买通物流各节点信息服务,致力于成为全球最大的物流信息枢纽中心,现在支持600 以上快递物流公司接口一次性对接,为企业级用户提供尺度的物流接口和电商物流模块整体解决方案,各零售平台商只需要简朴的对接,就具备了完整的物流服务能力。


本文关键词:快递,单号,查询,接口,对接,教程,.net,源码,「,pp电子官网

本文来源:pp电子-www.hzmxty.com

网上报名

学校信息

职业资格证即职业资格证书,是表明劳动者具有从事某一职业所必备的学识和技能的证明。它是劳动者求职、任职、开业的资格凭证,是用人单位招聘、录用劳动者的主要依据,也是境外就业、对外劳务合作人员办理技能水平公...

同类课程推荐

返回顶部