EagletAPI / OpenAPI / 实时查询轨迹

实时查询轨迹

接口描述: 查询实时空运提单轨迹信息,目前支持 南方航空784 东方航空112 海南航空880 加拿大航空014 国泰航空160 长荣航空695 大韩航空180 近期更新支持下列航空 厦门航空731 全日空航空205

HTTP/HTTPS
请求协议
GET/POST
请求方式
UTF-8
编码格式
JSON
返回格式

接口参数

参数名字类型是否必须默认值其他说明
access_token字符串可选访问令牌,仅当开启签名验证时需要传递,生成令牌可使用App.Auth.ApplyToken接口
awb_number字符串必须-航空提单号 如:784-646281xx

返回字段

返回结果类型说明
ret整型状态码,200表示成功,4xx表示客户端非法请求,5xx表示服务器错误
data对象或混合类型业务数据,由各自接口指定,通常为对象
msg字符串提示信息,失败时的错误提示

在线测试   

参数是否必须
service 必须
access_token 可选
awb_number 必须

客户端请求示例

{
  "ret": 200,
  "data": {
    "book": {
      "id": 16,
      "app_key": "",
      "airline": "",
      "book_number": "46058530",
      "book_flight": "TAOCZ/YYZ",
      "departure_station": "TAO",
      "arrival_station": "YYZ",
      "flight_number": "CZ8117",
      "flight_date": "2021-07-08 00:00:00",
      "pieces": 69,
      "weight": 575,
      "volume": 3.35,
      "nature_of_booking": "KK",
      "air_waybill": "784-64626262",
      "master_number": "784",
      "waybill_number": "64626262",
      "create_time": "2021-07-25 15:11:15",
      "update_time": "2021-08-08 23:17:19",
      "delete_time": null
    },
    "voyage": [
      {
        "id": 16,
        "app_key": "",
        "book_id": "",
        "flight_number": "",
        "departure_station": "",
        "arrival_station": "",
        "flight_time": null,
        "departure_time": null,
        "arrival_time": null,
        "carrier": "CZ",
        "voyage": "青岛(TAO)--多伦多机场(YYZ)",
        "goods_name": "CONSOLCARGOIMITATIONJEWELRY",
        "pieces": 69,
        "weight": 575,
        "volume": 3.35,
        "air_waybill": "784-64626262",
        "master_number": "784",
        "waybill_number": "64626262",
        "status": 0,
        "note": null,
        "create_time": "2021-07-25 15:11:15",
        "update_time": "2021-08-08 23:17:19",
        "delete_time": null
      }
    ],
    "track": [
      {
        "id": 127,
        "app_key": "",
        "order_id": "",
        "operate_time": "2021-07-08 09:30:27",
        "operate_site": "青岛",
        "flight_number": "",
        "order_status_content": "运单已接收。",
        "order_status": null,
        "pieces": 0,
        "weight": 0,
        "volume": 0,
        "air_waybill": "784-64626262",
        "master_number": "784",
        "waybill_number": "64626262",
        "note": "",
        "create_time": null,
        "update_time": null,
        "delete_time": null
      },
      {
        "id": 128,
        "app_key": "",
        "order_id": "",
        "operate_time": "2021-07-08 09:30:27",
        "operate_site": "青岛",
        "flight_number": "",
        "order_status_content": "货物已接收。",
        "order_status": null,
        "pieces": 69,
        "weight": 575,
        "volume": 0,
        "air_waybill": "784-64626262",
        "master_number": "784",
        "waybill_number": "64626262",
        "note": "",
        "create_time": null,
        "update_time": null,
        "delete_time": null
      },
      {
        "id": 129,
        "app_key": "",
        "order_id": "",
        "operate_time": "2021-07-08 10:20:00",
        "operate_site": "青岛",
        "flight_number": "CZ8117",
        "order_status_content": "货物已装机。",
        "order_status": null,
        "pieces": 69,
        "weight": 575,
        "volume": 0,
        "air_waybill": "784-64626262",
        "master_number": "784",
        "waybill_number": "64626262",
        "note": "",
        "create_time": null,
        "update_time": null,
        "delete_time": null
      },
      {
        "id": 130,
        "app_key": "",
        "order_id": "",
        "operate_time": "2021-07-08 10:43:28",
        "operate_site": "青岛",
        "flight_number": "CZ8117",
        "order_status_content": "航班已起飞。",
        "order_status": null,
        "pieces": 0,
        "weight": 0,
        "volume": 0,
        "air_waybill": "784-64626262",
        "master_number": "784",
        "waybill_number": "64626262",
        "note": "",
        "create_time": null,
        "update_time": null,
        "delete_time": null
      },
      {
        "id": 131,
        "app_key": "",
        "order_id": "",
        "operate_time": "2021-07-08 11:14:00",
        "operate_site": "多伦多机场",
        "flight_number": "",
        "order_status_content": "运单已接收。",
        "order_status": null,
        "pieces": 0,
        "weight": 0,
        "volume": 0,
        "air_waybill": "784-64626262",
        "master_number": "784",
        "waybill_number": "64626262",
        "note": "",
        "create_time": null,
        "update_time": null,
        "delete_time": null
      },
      {
        "id": 132,
        "app_key": "",
        "order_id": "",
        "operate_time": "2021-07-08 11:14:00",
        "operate_site": "多伦多机场",
        "flight_number": "",
        "order_status_content": "货物已接收。",
        "order_status": null,
        "pieces": 69,
        "weight": 575,
        "volume": 0,
        "air_waybill": "784-64626262",
        "master_number": "784",
        "waybill_number": "64626262",
        "note": "",
        "create_time": null,
        "update_time": null,
        "delete_time": null
      },
      {
        "id": 133,
        "app_key": "",
        "order_id": "",
        "operate_time": "2021-07-08 17:53:00",
        "operate_site": "多伦多机场",
        "flight_number": "",
        "order_status_content": "已通知提货。",
        "order_status": null,
        "pieces": 0,
        "weight": 0,
        "volume": 0,
        "air_waybill": "784-64626262",
        "master_number": "784",
        "waybill_number": "64626262",
        "note": "",
        "create_time": null,
        "update_time": null,
        "delete_time": null
      },
      {
        "id": 134,
        "app_key": "",
        "order_id": "",
        "operate_time": "2021-07-09 07:23:00",
        "operate_site": "多伦多机场",
        "flight_number": "",
        "order_status_content": "货物已被W T EXPRESS CANADA  提取。",
        "order_status": null,
        "pieces": 69,
        "weight": 575,
        "volume": 0,
        "air_waybill": "784-64626262",
        "master_number": "784",
        "waybill_number": "64626262",
        "note": "",
        "create_time": null,
        "update_time": null,
        "delete_time": null
      }
    ]
  },
  "msg": ""
}

错误列表

错误状态码错误描述信息
400ret=400,客户端参数错误或非法请求
404表示接口服务不存在
406ret=406,access_token令牌校验不通过
407ret=407,app_key权限不足,或未知应用
408ret=408,当前用户禁止使用,或用户未登录
500表示服务端内部错误

本文档生成时间:2024-11-21 17:43:08