快递查询
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>快递查询
<pre><code class="language-css">请求头中需带上TokenValue字段,传参接收到的token值,用于用户验证</code></pre></li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>/api/v1/order/express</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST </li>
</ul>
<h5>参数</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">jsonstr</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>请求字符串</td>
</tr>
<tr>
<td style="text-align: left;">token</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>token密钥</td>
</tr>
</tbody>
</table>
<table>
<thead>
<tr>
<th style="text-align: left;">jsonstr参数名</th>
<th style="text-align: left;">必选</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">express_no</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>快递单号</td>
</tr>
<tr>
<td style="text-align: left;">order_num</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>订单编号</td>
</tr>
</tbody>
</table>
<h5>成功返回示例</h5>
<ul>
<li>返回json格式,请参考阿里云接口
<a href="https://market.aliyun.com/apimarket/detail/cmapi00061252?spm=5176.730005.result.44.7b873524FPlrdO#sku=yuncode5525200005">https://market.aliyun.com/apimarket/detail/cmapi00061252?spm=5176.730005.result.44.7b873524FPlrdO#sku=yuncode5525200005</a></li>
</ul>
<pre><code>{
&quot;state&quot;: &quot;1&quot;,
&quot;msg&quot;: &quot;成功&quot;,
&quot;data&quot;: &quot;{\&quot;data\&quot;:{\&quot;expressCode\&quot;:\&quot;YTO\&quot;,\&quot;expressCompanyName\&quot;:\&quot;圆通速递\&quot;,\&quot;expressCompanyLogo\&quot;:\&quot;https://img2.jumdata.com/express-logo/yuantong.png\&quot;,\&quot;number\&quot;:\&quot;YT7479004171601\&quot;,\&quot;logisticsStatus\&quot;:\&quot;SIGN\&quot;,\&quot;logisticsStatusDesc\&quot;:\&quot;已签收\&quot;,\&quot;theLastMessage\&quot;:\&quot;您的快件已签收,签收人在[代收点](驿站之家)取件,如有疑问请联系站点:13129861664,业务员电话:18576368845,投诉电话:0769-22083911。感谢使用圆通速递,期待再次为您服务!\&quot;,\&quot;theLastTime\&quot;:\&quot;2024-07-14 14:17:58\&quot;,\&quot;takeTime\&quot;:\&quot;0天18小时12分\&quot;,\&quot;courierPhone\&quot;:\&quot;18576368845\&quot;,\&quot;logisticsTraceDetails\&quot;:[{\&quot;areaName\&quot;:\&quot;汕头市\&quot;,\&quot;subLogisticsStatus\&quot;:\&quot;ACCEPT\&quot;,\&quot;time\&quot;:1720872351000,\&quot;logisticsStatus\&quot;:\&quot;ACCEPT\&quot;,\&quot;desc\&quot;:\&quot;您的快件在【广东省汕头市龙湖区龙翔】已揽收,揽收人: 龙靖松(18212436948)\&quot;},{\&quot;areaName\&quot;:\&quot;汕头市\&quot;,\&quot;subLogisticsStatus\&quot;:\&quot;TRANSPORT\&quot;,\&quot;time\&quot;:1720873520000,\&quot;logisticsStatus\&quot;:\&quot;TRANSPORT\&quot;,\&quot;desc\&quot;:\&quot;您的快件离开【广东省汕头市龙湖区龙翔】,已发往【揭阳转运中心】\&quot;},{\&quot;areaName\&quot;:\&quot;汕头市\&quot;,\&quot;subLogisticsStatus\&quot;:\&quot;ON_THE_WAY\&quot;,\&quot;time\&quot;:1720880781000,\&quot;logisticsStatus\&quot;:\&quot;TRANSPORT\&quot;,\&quot;desc\&quot;:\&quot;您的快件已经到达【揭阳转运中心】\&quot;},{\&quot;areaName\&quot;:\&quot;汕头市\&quot;,\&quot;subLogisticsStatus\&quot;:\&quot;TRANSPORT\&quot;,\&quot;time\&quot;:1720880918000,\&quot;logisticsStatus\&quot;:\&quot;TRANSPORT\&quot;,\&quot;desc\&quot;:\&quot;您的快件离开【揭阳转运中心】,已发往【东莞转运中心】\&quot;},{\&quot;areaName\&quot;:\&quot;东莞市\&quot;,\&quot;subLogisticsStatus\&quot;:\&quot;ON_THE_WAY\&quot;,\&quot;time\&quot;:1720905767000,\&quot;logisticsStatus\&quot;:\&quot;TRANSPORT\&quot;,\&quot;desc\&quot;:\&quot;您的快件已经到达【东莞转运中心】\&quot;},{\&quot;areaName\&quot;:\&quot;东莞市\&quot;,\&quot;subLogisticsStatus\&quot;:\&quot;TRANSPORT\&quot;,\&quot;time\&quot;:1720907434000,\&quot;logisticsStatus\&quot;:\&quot;TRANSPORT\&quot;,\&quot;desc\&quot;:\&quot;您的快件离开【东莞转运中心】,已发往【广东省东莞市新东城】\&quot;},{\&quot;areaName\&quot;:\&quot;东莞市\&quot;,\&quot;subLogisticsStatus\&quot;:\&quot;DELIVERING\&quot;,\&quot;time\&quot;:1720919234000,\&quot;logisticsStatus\&quot;:\&quot;DELIVERING\&quot;,\&quot;desc\&quot;:\&quot;【广东省东莞市新东城】的张远乐(18576368845)正在派件,请耐心等待!如有疑问请联系网点:0769-22083911,投诉电话:0769-22083911。[95161和185211号段的上海号码为圆通业务员专属号码,请放心接听]\&quot;},{\&quot;areaName\&quot;:\&quot;东莞市\&quot;,\&quot;subLogisticsStatus\&quot;:\&quot;STA_INBOUND\&quot;,\&quot;time\&quot;:1720930039000,\&quot;logisticsStatus\&quot;:\&quot;DELIVERING\&quot;,\&quot;desc\&quot;:\&quot;您的快件已到达[代收点]中惠丽阳时代133号店,请及时取件,如有疑问请联系站点:13129861664,业务员电话:18576368845,投诉电话:0769-22083911。感谢使用圆通速递,期待再次为您服务!\&quot;},{\&quot;areaName\&quot;:\&quot;东莞市\&quot;,\&quot;subLogisticsStatus\&quot;:\&quot;SIGN\&quot;,\&quot;time\&quot;:1720937878000,\&quot;logisticsStatus\&quot;:\&quot;SIGN\&quot;,\&quot;desc\&quot;:\&quot;您的快件已签收,签收人在[代收点](驿站之家)取件,如有疑问请联系站点:13129861664,业务员电话:18576368845,投诉电话:0769-22083911。感谢使用圆通速递,期待再次为您服务!\&quot;}]},\&quot;msg\&quot;:\&quot;成功\&quot;,\&quot;success\&quot;:true,\&quot;code\&quot;:200,\&quot;taskNo\&quot;:\&quot;095186322231303451188103\&quot;,\&quot;charge\&quot;:true}&quot;
}</code></pre>
<pre><code> {
&quot;code&quot;: 200, //接口返回码【注意:不等于HTTP响应状态码】
&quot;msg&quot;: &quot;成功&quot;, //接口返回码对应的描述信息
&quot;taskNo&quot;: &quot;89889414666618686491&quot;, //任务订单号【可反馈服务商复核对应订单】
&quot;data&quot;: {
&quot;expressCode&quot;: &quot;SF&quot;,// 快递公司编号
&quot;expressCompanyName&quot;: &quot;顺丰快递&quot;,// 快递名称
&quot;logisticsStatus&quot;: &quot;TRANSPORT&quot;,// 物流状态英文说明,详见:物流状态编码详情表
&quot;logisticsStatusDesc&quot;: &quot;运输中&quot;,// 物流状态中文说明
&quot;number&quot;: &quot;SF6091886583866&quot;,// 运单编号
&quot;theLastMessage&quot;: &quot;快件在【合肥花峰中转场】完成分拣,准备发往 【泉州磁灶中转场】&quot;,// 物流最新描述
&quot;theLastTime&quot;: &quot;2022-12-16 04:25:57&quot;, // 物流最新变更时间
&quot;takeTime&quot;: &quot;&quot;, //从揽收到送达所用时间
&quot;courier&quot;: &quot;&quot;, // 快递员
&quot;courierPhone&quot;: &quot;&quot;, // 快递员联系方式
&quot;logisticsTraceDetails&quot;: [ // 物流详情
{
&quot;areaCode&quot;: &quot;CN341200000000&quot;, // 所在地区行政编码
&quot;areaName&quot;: &quot;安徽省,阜阳市&quot;, // 所在地区名称
&quot;subLogisticsStatus&quot;: &quot;TRANSPORT&quot;, // 物流子状态英文说明 详见:物流状态编码详情表
&quot;time&quot;: 1671092783000, // 物流变更时间【毫秒时间戳】
&quot;logisticsStatus&quot;: &quot;TRANSPORT&quot;, // 物流状态英文说明 详见:物流状态编码详情表
&quot;desc&quot;: &quot;快件放至【风华苑11号楼西侧丰巢柜】【丰巢智能快递柜】&quot; //物流描述
},
......
{
&quot;areaCode&quot;: &quot;CN340100000000&quot;,
&quot;areaName&quot;: &quot;安徽省,合肥市&quot;,
&quot;subLogisticsStatus&quot;: &quot;TRANSPORT&quot;,
&quot;time&quot;: 1671135957000,
&quot;logisticsStatus&quot;: &quot;TRANSPORT&quot;,
&quot;desc&quot;: &quot;快件在【合肥花峰中转场】完成分拣,准备发往 【泉州磁灶中转场】&quot;
}
]
}
}</code></pre>
<h5>失败返回示例</h5>
<pre><code> {
&quot;state&quot;: &quot;-999&quot;,
&quot;msg&quot;: &quot;拒绝访问:你没有权限&quot;,
&quot;data&quot;: &quot;&quot;
}</code></pre>
<h5>返回参数说明</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">state</td>
<td style="text-align: left;">string</td>
<td>状态 1为成功,其他为失败</td>
</tr>
<tr>
<td style="text-align: left;">msg</td>
<td style="text-align: left;">string</td>
<td>接口返回信息</td>
</tr>
<tr>
<td style="text-align: left;">data</td>
<td style="text-align: left;">string</td>
<td>数据域</td>
</tr>
</tbody>
</table>
<h5>错误代码</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">代码名称</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">1</td>
<td style="text-align: left;">string</td>
<td>成功</td>
</tr>
<tr>
<td style="text-align: left;">-1</td>
<td style="text-align: left;">string</td>
<td>参数有误</td>
</tr>
<tr>
<td style="text-align: left;">-99</td>
<td style="text-align: left;">string</td>
<td>异常</td>
</tr>
<tr>
<td style="text-align: left;">-999</td>
<td style="text-align: left;">string</td>
<td>拒绝访问:你没有权限</td>
</tr>
<tr>
<td style="text-align: left;">-9999</td>
<td style="text-align: left;">string</td>
<td>token验证失败</td>
</tr>
</tbody>
</table>