航变通知

当 Atlas 收到已确认的航班时刻变更或取消信息时发送的 webhook 事件。

遇到 API 接入问题时，可登录 Eva 寻求帮助。

当已出票行程发生变化时，使用这个 webhook。

触发时机

当航段发生变化或被取消时，Atlas 会发送 order.schedulechange。

收到后建议处理

收到事件后，建议：

• 对比 previousSegs、revisedSegs 和 originalSegs

• 判断是时刻变更还是航班取消

• 通知受影响旅客

• 按需触发改签、退款或客服流程

推送方式

Atlas 会向你已注册的 webhook 地址发起 POST 请求。

建议优先读取的字段

• type

• data.orderNo

• data.scheduleChangeType

• data.previousSegs

• data.revisedSegs

• data.originalSegs

航变类型

• 1：航变

• 2：航班取消

典型载荷

{
  "cid": "XXXXXXX",
  "notificationId": "20230917143240511TATVO",
  "status": 0,
  "type": "order.schedulechange",
  "data": {
    "orderNo": "ATXFQ20230720193244809",
    "scheduleChangeType": 1,
    "previousSegs": [],
    "revisedSegs": [],
    "originalSegs": []
  }
}

说明

• status 表示事件确认状态，不代表订单成功状态

• 取消场景下，revisedSegs 可能为空

• originalSegs 保留旅客最初预订的行程

字段说明

cid

• 类型： String

• 是否必填： 是

• 说明： 用于跟踪请求的客户唯一标识。

notificationId

• 类型： String

• 是否必填： 是

• 说明： 通知事件唯一标识。

status

• 类型： Integer

• 是否必填： 是

• 说明： 事件状态。

• 可选值：

  • 0：未确认

  • 1：已确认

type

• 类型： String

• 是否必填： 是

• 说明： 固定为 order.schedulechange。

data.orderNo

• 类型： String

• 是否必填： 是

• 说明： 订单唯一编号。

data.scheduleChangeType

• 类型： Integer

• 是否必填： 是

• 说明： 航变类型。

• 可选值：

  • 1：航变

  • 2：航班取消

data.previousSegs

• 类型： Object 数组

• 说明： 本次变更前的航段信息。

data.revisedSegs

• 类型： Object 数组

• 说明： 本次变更后的航段信息。取消场景可能为空数组。

data.originalSegs

• 类型： Object 数组

• 说明： 旅客下单时的原始航段信息。

示例

相关页面

• Webhook 概览

• 事件通知

• 事件查询