查询空运运单轨迹
# 接口地址
POST https://api.track123.com/gateway/open-api/tk/v1/aviation/track/query
# 接口描述
一次最多可以查询100个运单轨迹信息。响应的结果包含accepted和rejected两个列表,如果有未注册的跟踪号,将在rejected列表中返回。
# 请求参数
参数名称 | 参数说明 | 必须 | 数据类型 |
---|---|---|---|
trackingNo | 查询单号 | true | string |
# 请求示例
[
{
"carrierCode": "atlasair",
"trackingNo": "369-84941043"
},
{
"carrierCode": "atlasair",
"trackingNo": "369-987654321"
},
{
"carrierCode": "atlasair",
"trackingNo": "369-123"
}
]
# 响应参数
参数名称 | 参数说明 | 类型 |
---|---|---|
code | 业务状态码 | string |
msg | 业务状态码对应的描述信息或者其他辅助的描述信息 | string |
data | 返回体 | object |
accepted | 成功的单号 | array[object] |
id | 主键 | String |
trackingNo | 单号 | String |
aviationTransitStatus | 状态 | string |
weight | 重量 | number |
piece | 件数 | integer |
timeZone | 时区 | string |
origin | 始发站(简码) | String |
destination | 目的站(简码) | String |
carrierInfo | 航司信息 | object |
carrierCode | 承运人对应的唯一简码 | String |
carrierHomePage | 承运人官网链接 | String |
carrierNameCN | 承运人中文名称 | String |
carrierNameEN | 承运人英文名称 | String |
flightInfo | 航线信息 | array[object] |
ata | 抵达时间 | string |
atd | 起飞时间 | string |
eta | 预抵时间 | string |
etd | 预离时间 | string |
flightNo | 航班 | string |
shipFrom | 出发站 | string |
shipTo | 到达站 | string |
trackDetails | 轨迹信息 | array[object] |
status | 状态 | string |
originStatus | 轨迹原始状态 | string |
event | 事件 | string |
eventTime | 事件时间 | string |
actualTime | 实际时间 | string |
planTime | 计划时间 | string |
flightNo | 航班 | string |
weight | 重量(kg) | number |
piece | 件数 | integer |
station | 地点 | string |
rejected | 注册失败的单号 | array[object] |
trackingNo | 查询单号 | String |
error | 错误 | object |
code | 错误码 | String |
msg | 业务状态码对应的描述信息或者其他辅助的描述信息 | String |
# 响应示例
{
"code": "00000",
"data": {
"accepted": [
{
"trackingNo": "369-84941043",
"origin": "HKG",
"destination": "GRU",
"piece": 13,
"weight": 288,
"timeZone": "UTC+00:00",
"aviationTransitStatus": "EXPIRED",
"carrierInfo": {
"carrierCode": "atlasair",
"carrierNameCN": "美国阿特拉斯航空公司",
"carrierNameEN": "Atlas Air",
"carrierHomePage": "https://www.atlasair.com/"
},
"flightInfo": [
{
"flightNo": "5Y8052",
"shipFrom": "HKG",
"shipTo": "GRU",
"atd": "2022-08-27 04:30:00"
}
],
"trackDetails": [
{
"status": "RCF",
"originStatus": "RCS",
"actualTime": "2022-08-27 05:58:00",
"eventTime": "2022-08-27 05:58:00",
"event": "Received Cargo from Shipper",
"station": "HKG",
"flightNo": "",
"piece": 13,
"weight": 1
},
{
"status": "DEP",
"originStatus": "DEP",
"actualTime": "2022-08-27 04:30:00",
"eventTime": "2022-08-27 04:30:00",
"event": "Departed Flight",
"station": "HKG",
"flightNo": "5Y8052",
"piece": 13,
"weight": 288
},
{
"status": "DEP",
"originStatus": "DEP",
"actualTime": "2022-08-27 04:30:00",
"eventTime": "2022-08-27 04:30:00",
"event": "Departed Flight",
"station": "HKG",
"flightNo": "5Y8052",
"piece": 13,
"weight": 288
}
]
},
{
"trackingNo": "369-987654321",
"piece": 0,
"weight": 0,
"timeZone": "UTC+00:00",
"aviationTransitStatus": "NO_RECORD",
"carrierInfo": {
"carrierCode": "atlasair",
"carrierNameCN": "美国阿特拉斯航空公司",
"carrierNameEN": "Atlas Air",
"carrierHomePage": "https://www.atlasair.com/"
}
}
],
"rejected": [
{
"trackingNo": "369-123",
"error": {
"msg": "该运单尚未注册",
"code": "A0400"
}
}
]
},
"msg": "成功",
"traceId": "6058fd26a116449899a3b98c6a52547a.147.16709342450670653"
}