物流轨迹是什么？
物流轨迹是指当订单打印发货后，其快件包裹自快递揽收起，到收件人签售期间的物流路由信息，通常不论是寄件方或收件方在各种场景下都会具有查询快递包裹物流信息的需求。
物流轨迹API是什么？
由具备开发能力的互联网公司整合市面上所有快递公司的物流查询服务，统一并面向社会开放的免费或付费接入调用快递单号物流信息查询能力的端口，此解决方案需要使用者具备一定的开发能力，方可对接。
轨迹API适用哪些场景？
物流轨迹API能力主要面向电商平台、APP商城、自建商城、微信小程序商城、企业内部查单系统等，接入后即可解决平台或企业内部所有需要查询包裹物流信息的需求。主要应用场景通常为：
- 买家物流查询：轨迹跟踪、包裹进度、预计送达时间、派件小哥联系方式等；
- 卖家物流跟踪：是否超区、转件、多次派送、拒收；
- 平台物流监控：假交易监控、匹配卖家发货与顾客确认收货时间。
接入物流轨迹API的优势？
- 开发物流模块时，免去自行对接各家物流公司不统一的接口标准，省时省力；
- 电商平台嵌入页，接入后即可实现客户在自己的订单详情中自主查询订单物流信息；
- 无开发能力时，同样可通过输入单个单号/批量导入运单号查询能力获得物流信息；
- 此类开放接口通常具备以下特征：
- 实时查询、接口稳定；
- 覆盖快递公司面广，支持市场上所有快递；
- 价格低廉、性价比巨高；
- 使用形式多样化，可调用接口或直接提供h5嵌入页；
如何接入物流轨迹API？
此处以阿里云上的产品为例：【快递助手】物流轨迹查询API
- 订购物流轨迹API产品（此处以产品一为例）
根据自己的需求选择相应的产品及套餐进行订购，包含3款产品，均可免费试用：
- 产品一：按单号订阅次数收费API，同个单号订阅后查询多次不收费【查看商品】
- 产品二：按单号查询次数收费API，每调用1次查询接口即收费1次【查看商品】
- 产品三：地图轨迹调用收费API，直接提供上文下图的物流展示接口【查看商品】
- 获取对接appcode
- 登录自己的阿里云买家管理控制台：前往
- 获取所订购应用的appcode后，即可开始对接
3.单号识别快递公司
a. 调用地址：http(s)://kdzsgw.market.alicloudapi.com/logistics/discern
b. 请求方式：POST
返回类型：JSON
API 调用：API 简单身份认证调用方法（APPCODE）
API 签名认证调用方法（AppKey & AppSecret）
c. 请求示例
publicstaticvoidmain(String[] args) { Stringhost="https://kdzsgw.market.alicloudapi.com"; Stringpath="/logistics/discern"; Stringmethod="POST"; Stringappcode="你自己的AppCode"; Map<String, String>headers=newHashMap<String, String>(); //最后在header中的格式(中间是英文空格)为Authorization:APPCODE 83359fd73fe94948385f570e3c139105headers.put("Authorization", "APPCODE "+appcode); //根据API的要求，定义相对应的Content-Typeheaders.put("Content-Type", "application/x-www-form-urlencoded; charset=UTF-8"); Map<String, String>querys=newHashMap<String, String>(); Map<String, String>bodys=newHashMap<String, String>(); bodys.put("mailNo", "YT1223434234"); try { /*** 重要提示如下:* HttpUtils请从* https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/src/main/java/com/aliyun/api/gateway/demo/util/HttpUtils.java* 下载** 相应的依赖请参照* https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/pom.xml*/HttpResponseresponse=HttpUtils.doPost(host, path, method, headers, querys, bodys); System.out.println(response.toString()); //获取response的body//System.out.println(EntityUtils.toString(response.getEntity())); } catch (Exceptione) { e.printStackTrace(); } }
//using System.IO;//using System.Text;//using System.Net;//using System.Net.Security;//using System.Security.Cryptography.X509Certificates;privateconstStringhost="https://kdzsgw.market.alicloudapi.com"; privateconstStringpath="/logistics/discern"; privateconstStringmethod="POST"; privateconstStringappcode="你自己的AppCode"; staticvoidMain(string[] args) { Stringquerys=""; Stringbodys="mailNo=YT1223434234"; Stringurl=host+path; HttpWebRequesthttpRequest=null; HttpWebResponsehttpResponse=null; if (0<querys.Length) { url=url+"?"+querys; } if (host.Contains("https://")) { ServicePointManager.ServerCertificateValidationCallback=newRemoteCertificateValidationCallback(CheckValidationResult); httpRequest= (HttpWebRequest)WebRequest.CreateDefault(newUri(url)); } else { httpRequest= (HttpWebRequest)WebRequest.Create(url); } httpRequest.Method=method; httpRequest.Headers.Add("Authorization", "APPCODE "+appcode); //根据API的要求，定义相对应的Content-TypehttpRequest.ContentType="application/x-www-form-urlencoded; charset=UTF-8"; if (0<bodys.Length) { byte[] data=Encoding.UTF8.GetBytes(bodys); using (Streamstream=httpRequest.GetRequestStream()) { stream.Write(data, 0, data.Length); } } try { httpResponse= (HttpWebResponse)httpRequest.GetResponse(); } catch (WebExceptionex) { httpResponse= (HttpWebResponse)ex.Response; } Console.WriteLine(httpResponse.StatusCode); Console.WriteLine(httpResponse.Method); Console.WriteLine(httpResponse.Headers); Streamst=httpResponse.GetResponseStream(); StreamReaderreader=newStreamReader(st, Encoding.GetEncoding("utf-8")); Console.WriteLine(reader.ReadToEnd()); Console.WriteLine("\n"); } publicstaticboolCheckValidationResult(objectsender, X509Certificatecertificate, X509Chainchain, SslPolicyErrorserrors) { returntrue; }
更多语言详见：商品详情页
d. 返回示例
正常示例
{ "code": 100, "data": [ { "companyName": "圆通快递", "cpCode": "YTO" } ] }
失败示例
{ "code": 500, "errorMsg": "系统异常" }
e. 技术手册详见：商品详情页
