事件通知

当 Atlas 检测到邮件航变、API 航变或未对账取消等订单级事件时发送的 webhook 事件。

当 Atlas 检测到影响订单的运营事件时,使用这个 webhook。

触发时机

以下场景会触发事件通知:

  • email.schedulechange

  • order.schedulechange

  • abnormal.cancelled

收到后建议处理

收到事件后,建议:

  • 先识别事件类型

  • 判断是否需要旅客进一步处理

  • 必要时通知受影响旅客

  • 结合事件查询或订单查询继续排查

推送方式

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

建议优先读取的字段

  • type

  • notificationId

  • status

  • data.orderNo

然后再根据 type 读取对应的事件字段。

事件类型

email.schedulechange

Atlas 收到了航司发出的航变邮件。 重点看 data.emailSubjectdata.emailLink

order.schedulechange

Atlas 提供了结构化航变数据。 重点看航段数组和 scheduleChangeType

abnormal.cancelled

Atlas 检测到异常取消。 重点看订单号和取消相关字段。

说明

  • status 表示事件确认状态

  • emailLink 是临时链接,必要时请尽快保存内容

  • 依赖这些通知前,请先完成 webhook 地址注册

注册请求示例

cid

  • 类型: String

  • 是否必填:

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

type

  • 类型: String

  • 是否必填:

  • 说明: 事件类型。

  • 可选值:

    • email.schedulechange:邮件航变通知

    • order.schedulechange:API 航变通知

    • abnormal.cancelled:未对账取消

notificationId

  • 类型: String

  • 是否必填:

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

status

  • 类型: Integer

  • 是否必填:

  • 说明: 事件状态。

  • 可选值:

    • 0:未确认

    • 1:已确认

data.orderNo

  • 类型: String

  • 是否必填:

  • 说明: 订单唯一编号。

data.emailSubject

  • 类型: String

  • 说明: 邮件航变场景下的邮件主题。

data.emailLink

  • 类型: String (URL)

  • 说明: 邮件详情链接。通常只有短时效。

相关页面

Last updated

Was this helpful?