获取物流轨迹
# 获取物流轨迹
### 请求地址
| HTTP Method | Path |
| :---------- | :-------------- |
| GET | /api/v1/express |
### 请求参数
| 参数名称 | 类型 | 必填 | 描述 |
| :------- | :----- | :--- | :----- |
| orderNo | string | 是 | 订单号 |
### 请求Body
无
### 响应Body,Data部分
| 参数名称 | 类型 | 描述 |
| :------------ | :------------ | :--------------------------------- |
| expressNo | string | 快递单号 |
| company | string | 快递公司名称 |
| companyNo | string | 快递公司编号 |
| status | string | 快递单当前状态<br />具体见下方表格 |
| expressDetail | *ContextItem*[] | 快递详情 |
*ContextItem*
| 参数名称 | 类型 | 描述 |
| :------- | :----- | :--- |
| time | string | 时间 |
| context | string | 内容 |
*Status*
| 值 | 说明 |
| :--- | :--------- |
| -1 | 未发货 |
| 0 | 在途 |
| 1 | 揽收 |
| 2 | 疑难 |
| 3 | 签收 |
| 4 | 退签 |
| 5 | 派件 |
| 6 | 退回 |
| 7 | 转单 |
| 10 | 待清关 |
| 11 | 清关中 |
| 12 | 已清关 |
| 13 | 清关异常 |
| 14 | 收件人拒签 |
### 业务错误码
| Error Code | HTTP Status Code | Error Message |
| :- | :-| :- | :-|
| OrderNoNotExist| 400 | 订单号不存在 |
### 请求示例
``` http
GET http://test.openapi.huitravel.com/api/v1/express?orderNo=2011171621521053 HTTP/1.1
accessKeyId: 7568512625
signatureNonce: 0.8989166537760369
timestamp: 2020-11-27T06:50:49Z
signature: b72a50a4c59de3ec61b85b76e93fdd8c3cfa5adc
...
```
``` json
HTTP/1.1 200 OK
{
"requestId": "d02f9ae8-e4fa-465d-b8f9-fa6462bbb49a",
"data": {
"expressNo": "4309****6829",
"company": "韵达快递",
"companyNo": "yunda",
"status": "3",
"expressDetail": [
{
"time": "2020-11-15 17:42:31",
"context": "【代收点】您的快件已签收,签收人在【深圳**店(已签收签收人凭取货码签收)】领取。"
},
{
"time": "2020-11-15 14:52:17",
"context": "【代收点】您的快件已送达 深圳**店 保管,地址:快件已暂存至深圳**菜鸟驿站如有疑问请联系178****6758,请及时领取,如有疑问请电联快递员:陈**【134****3218】。"
},
{
"time": "2020-11-15 11:33:22",
"context": "【深圳市】广东深圳公司龙岗区布吉德福分部 快递员 陈*超134****3218 正在为您派件【95114/95121/9501395546为韵达快递员外呼专属号码,请放心接听】"
},
{
"time": "2020-11-15 09:08:41",
"context": "【深圳市】已离开 广东深圳公司龙华区甘坑分拨分部;发往 广东深圳公司龙岗区布吉德福分部"
},
{
"time": "2020-11-15 02:21:57",
"context": "【深圳市】已离开 广东深圳公司;发往 广东深圳公司龙华区甘坑分拨分部"
},
{
"time": "2020-11-15 00:49:35",
"context": "【深圳市】已到达 广东深圳公司"
},
{
"time": "2020-11-13 17:50:04",
"context": "【嘉兴市】已离开 浙江嘉兴分拨中心;发往 深东地区包"
},
{
"time": "2020-11-13 17:44:12",
"context": "【嘉兴市】已到达 浙江嘉兴分拨中心"
},
{
"time": "2020-11-13 01:23:43",
"context": "【嘉兴市】浙江平湖市公司-胡*力(135****5107) 已揽收"
}
]
}
}
```