笆林中控APP


快递查询

<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>{     &amp;quot;state&amp;quot;: &amp;quot;1&amp;quot;,     &amp;quot;msg&amp;quot;: &amp;quot;成功&amp;quot;,     &amp;quot;data&amp;quot;: &amp;quot;{\&amp;quot;data\&amp;quot;:{\&amp;quot;expressCode\&amp;quot;:\&amp;quot;YTO\&amp;quot;,\&amp;quot;expressCompanyName\&amp;quot;:\&amp;quot;圆通速递\&amp;quot;,\&amp;quot;expressCompanyLogo\&amp;quot;:\&amp;quot;https://img2.jumdata.com/express-logo/yuantong.png\&amp;quot;,\&amp;quot;number\&amp;quot;:\&amp;quot;YT7479004171601\&amp;quot;,\&amp;quot;logisticsStatus\&amp;quot;:\&amp;quot;SIGN\&amp;quot;,\&amp;quot;logisticsStatusDesc\&amp;quot;:\&amp;quot;已签收\&amp;quot;,\&amp;quot;theLastMessage\&amp;quot;:\&amp;quot;您的快件已签收,签收人在[代收点](驿站之家)取件,如有疑问请联系站点:13129861664,业务员电话:18576368845,投诉电话:0769-22083911。感谢使用圆通速递,期待再次为您服务!\&amp;quot;,\&amp;quot;theLastTime\&amp;quot;:\&amp;quot;2024-07-14 14:17:58\&amp;quot;,\&amp;quot;takeTime\&amp;quot;:\&amp;quot;0天18小时12分\&amp;quot;,\&amp;quot;courierPhone\&amp;quot;:\&amp;quot;18576368845\&amp;quot;,\&amp;quot;logisticsTraceDetails\&amp;quot;:[{\&amp;quot;areaName\&amp;quot;:\&amp;quot;汕头市\&amp;quot;,\&amp;quot;subLogisticsStatus\&amp;quot;:\&amp;quot;ACCEPT\&amp;quot;,\&amp;quot;time\&amp;quot;:1720872351000,\&amp;quot;logisticsStatus\&amp;quot;:\&amp;quot;ACCEPT\&amp;quot;,\&amp;quot;desc\&amp;quot;:\&amp;quot;您的快件在【广东省汕头市龙湖区龙翔】已揽收,揽收人: 龙靖松(18212436948)\&amp;quot;},{\&amp;quot;areaName\&amp;quot;:\&amp;quot;汕头市\&amp;quot;,\&amp;quot;subLogisticsStatus\&amp;quot;:\&amp;quot;TRANSPORT\&amp;quot;,\&amp;quot;time\&amp;quot;:1720873520000,\&amp;quot;logisticsStatus\&amp;quot;:\&amp;quot;TRANSPORT\&amp;quot;,\&amp;quot;desc\&amp;quot;:\&amp;quot;您的快件离开【广东省汕头市龙湖区龙翔】,已发往【揭阳转运中心】\&amp;quot;},{\&amp;quot;areaName\&amp;quot;:\&amp;quot;汕头市\&amp;quot;,\&amp;quot;subLogisticsStatus\&amp;quot;:\&amp;quot;ON_THE_WAY\&amp;quot;,\&amp;quot;time\&amp;quot;:1720880781000,\&amp;quot;logisticsStatus\&amp;quot;:\&amp;quot;TRANSPORT\&amp;quot;,\&amp;quot;desc\&amp;quot;:\&amp;quot;您的快件已经到达【揭阳转运中心】\&amp;quot;},{\&amp;quot;areaName\&amp;quot;:\&amp;quot;汕头市\&amp;quot;,\&amp;quot;subLogisticsStatus\&amp;quot;:\&amp;quot;TRANSPORT\&amp;quot;,\&amp;quot;time\&amp;quot;:1720880918000,\&amp;quot;logisticsStatus\&amp;quot;:\&amp;quot;TRANSPORT\&amp;quot;,\&amp;quot;desc\&amp;quot;:\&amp;quot;您的快件离开【揭阳转运中心】,已发往【东莞转运中心】\&amp;quot;},{\&amp;quot;areaName\&amp;quot;:\&amp;quot;东莞市\&amp;quot;,\&amp;quot;subLogisticsStatus\&amp;quot;:\&amp;quot;ON_THE_WAY\&amp;quot;,\&amp;quot;time\&amp;quot;:1720905767000,\&amp;quot;logisticsStatus\&amp;quot;:\&amp;quot;TRANSPORT\&amp;quot;,\&amp;quot;desc\&amp;quot;:\&amp;quot;您的快件已经到达【东莞转运中心】\&amp;quot;},{\&amp;quot;areaName\&amp;quot;:\&amp;quot;东莞市\&amp;quot;,\&amp;quot;subLogisticsStatus\&amp;quot;:\&amp;quot;TRANSPORT\&amp;quot;,\&amp;quot;time\&amp;quot;:1720907434000,\&amp;quot;logisticsStatus\&amp;quot;:\&amp;quot;TRANSPORT\&amp;quot;,\&amp;quot;desc\&amp;quot;:\&amp;quot;您的快件离开【东莞转运中心】,已发往【广东省东莞市新东城】\&amp;quot;},{\&amp;quot;areaName\&amp;quot;:\&amp;quot;东莞市\&amp;quot;,\&amp;quot;subLogisticsStatus\&amp;quot;:\&amp;quot;DELIVERING\&amp;quot;,\&amp;quot;time\&amp;quot;:1720919234000,\&amp;quot;logisticsStatus\&amp;quot;:\&amp;quot;DELIVERING\&amp;quot;,\&amp;quot;desc\&amp;quot;:\&amp;quot;【广东省东莞市新东城】的张远乐(18576368845)正在派件,请耐心等待!如有疑问请联系网点:0769-22083911,投诉电话:0769-22083911。[95161和185211号段的上海号码为圆通业务员专属号码,请放心接听]\&amp;quot;},{\&amp;quot;areaName\&amp;quot;:\&amp;quot;东莞市\&amp;quot;,\&amp;quot;subLogisticsStatus\&amp;quot;:\&amp;quot;STA_INBOUND\&amp;quot;,\&amp;quot;time\&amp;quot;:1720930039000,\&amp;quot;logisticsStatus\&amp;quot;:\&amp;quot;DELIVERING\&amp;quot;,\&amp;quot;desc\&amp;quot;:\&amp;quot;您的快件已到达[代收点]中惠丽阳时代133号店,请及时取件,如有疑问请联系站点:13129861664,业务员电话:18576368845,投诉电话:0769-22083911。感谢使用圆通速递,期待再次为您服务!\&amp;quot;},{\&amp;quot;areaName\&amp;quot;:\&amp;quot;东莞市\&amp;quot;,\&amp;quot;subLogisticsStatus\&amp;quot;:\&amp;quot;SIGN\&amp;quot;,\&amp;quot;time\&amp;quot;:1720937878000,\&amp;quot;logisticsStatus\&amp;quot;:\&amp;quot;SIGN\&amp;quot;,\&amp;quot;desc\&amp;quot;:\&amp;quot;您的快件已签收,签收人在[代收点](驿站之家)取件,如有疑问请联系站点:13129861664,业务员电话:18576368845,投诉电话:0769-22083911。感谢使用圆通速递,期待再次为您服务!\&amp;quot;}]},\&amp;quot;msg\&amp;quot;:\&amp;quot;成功\&amp;quot;,\&amp;quot;success\&amp;quot;:true,\&amp;quot;code\&amp;quot;:200,\&amp;quot;taskNo\&amp;quot;:\&amp;quot;095186322231303451188103\&amp;quot;,\&amp;quot;charge\&amp;quot;:true}&amp;quot; }</code></pre> <pre><code> {   &amp;quot;code&amp;quot;: 200, //接口返回码【注意:不等于HTTP响应状态码】   &amp;quot;msg&amp;quot;: &amp;quot;成功&amp;quot;,  //接口返回码对应的描述信息   &amp;quot;taskNo&amp;quot;:  &amp;quot;89889414666618686491&amp;quot;, //任务订单号【可反馈服务商复核对应订单】   &amp;quot;data&amp;quot;: {     &amp;quot;expressCode&amp;quot;: &amp;quot;SF&amp;quot;,// 快递公司编号     &amp;quot;expressCompanyName&amp;quot;: &amp;quot;顺丰快递&amp;quot;,// 快递名称     &amp;quot;logisticsStatus&amp;quot;: &amp;quot;TRANSPORT&amp;quot;,// 物流状态英文说明,详见:物流状态编码详情表     &amp;quot;logisticsStatusDesc&amp;quot;: &amp;quot;运输中&amp;quot;,// 物流状态中文说明     &amp;quot;number&amp;quot;: &amp;quot;SF6091886583866&amp;quot;,// 运单编号     &amp;quot;theLastMessage&amp;quot;: &amp;quot;快件在【合肥花峰中转场】完成分拣,准备发往 【泉州磁灶中转场】&amp;quot;,// 物流最新描述     &amp;quot;theLastTime&amp;quot;: &amp;quot;2022-12-16 04:25:57&amp;quot;, // 物流最新变更时间     &amp;quot;takeTime&amp;quot;: &amp;quot;&amp;quot;, //从揽收到送达所用时间     &amp;quot;courier&amp;quot;: &amp;quot;&amp;quot;, // 快递员     &amp;quot;courierPhone&amp;quot;: &amp;quot;&amp;quot;, // 快递员联系方式     &amp;quot;logisticsTraceDetails&amp;quot;: [ // 物流详情       {         &amp;quot;areaCode&amp;quot;: &amp;quot;CN341200000000&amp;quot;, // 所在地区行政编码         &amp;quot;areaName&amp;quot;: &amp;quot;安徽省,阜阳市&amp;quot;,  // 所在地区名称         &amp;quot;subLogisticsStatus&amp;quot;: &amp;quot;TRANSPORT&amp;quot;,  // 物流子状态英文说明 详见:物流状态编码详情表         &amp;quot;time&amp;quot;: 1671092783000,   // 物流变更时间【毫秒时间戳】         &amp;quot;logisticsStatus&amp;quot;: &amp;quot;TRANSPORT&amp;quot;,  // 物流状态英文说明 详见:物流状态编码详情表         &amp;quot;desc&amp;quot;: &amp;quot;快件放至【风华苑11号楼西侧丰巢柜】【丰巢智能快递柜】&amp;quot; //物流描述       },       ......       {         &amp;quot;areaCode&amp;quot;: &amp;quot;CN340100000000&amp;quot;,         &amp;quot;areaName&amp;quot;: &amp;quot;安徽省,合肥市&amp;quot;,         &amp;quot;subLogisticsStatus&amp;quot;: &amp;quot;TRANSPORT&amp;quot;,         &amp;quot;time&amp;quot;: 1671135957000,         &amp;quot;logisticsStatus&amp;quot;: &amp;quot;TRANSPORT&amp;quot;,         &amp;quot;desc&amp;quot;: &amp;quot;快件在【合肥花峰中转场】完成分拣,准备发往 【泉州磁灶中转场】&amp;quot;       }     ]   } }</code></pre> <h5>失败返回示例</h5> <pre><code> { &amp;quot;state&amp;quot;: &amp;quot;-999&amp;quot;, &amp;quot;msg&amp;quot;: &amp;quot;拒绝访问:你没有权限&amp;quot;, &amp;quot;data&amp;quot;: &amp;quot;&amp;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>

页面列表

ITEM_HTML