航变通知
当 Atlas 收到已确认的航班日程变更或取消时发送的 webhook 事件。
💬 需要帮助？ 如果遇到问题，请在帮助中心咨询 Eva，快速获取诊断建议。
当已出票的行程发生变化时，请使用此 webhook。
触发条件
当航班航段发生变更或被取消时，Atlas 发送 order.schedulechange。
您应该做什么
当您收到此事件时：
比较
previousSegs、revisedSegs和originalSegs确定变更是日程更新还是取消
通知受影响的旅客
根据需要创建内部改签、退款或支持工作流程
端点
POST 到您在 Atlas 注册的 webhook URL。
首先读取的字段
typedata.orderNodata.scheduleChangeTypedata.previousSegsdata.revisedSegsdata.originalSegs
日程变更类型
1: 日程变更2: 航班取消
典型负载
注意事项
status反映事件确认状态，而非预订成功状态在取消场景中，
revisedSegs可能为空originalSegs保留旅客预订的行程
cid
类型: 字符串
必填: 是
描述: 用于跟踪请求的唯一客户端标识符。
默认值: 无
示例:
"XXXXXXX"
notificationId
类型: 字符串
必填: 是
描述: 通知事件的唯一标识符。
默认值: 无
示例:
"20230917143240511TATVO"
status
类型: 整数
必填: 是
描述: 事件状态。
有效值：
0: 未确认
1: 已确认
默认值: 无
示例:
0
type
类型: 字符串
必填: 是
描述: 通知类型。对于日程变更，始终为
order.schedulechange。默认值: 无
示例:
"order.schedulechange"
data
类型: Object
必填: 是
描述: 包含之前、原始和修改后的航班航段。
默认值: 无
示例:
data.orderNo
类型: 字符串
必填: 是
描述: 与航班预订关联的唯一订单号。
默认值: 无
示例:
"ATXFQ20230720193244809"
data.scheduleChangeType
类型: 整数
必填: 是
描述: 日程变更的类型。
有效值：
1: 日程变更
2: 航班取消
默认值: 无
示例:
1
data.previousSegs
类型: 对象数组
必填: 是
描述: 包含此次日程变更前的航班航段详情。
默认值: 无
data.previousSegs[]
类型: Object
必填: 是
描述: 此次日程变更前的单个航班航段详情。
示例:
data.previousSegs[].depAirport
类型: 字符串
必填: 是
描述: 出发机场代码（IATA）。
默认值: 无
示例:
"HKG"
data.previousSegs[].arrAirport
类型: 字符串
必填: 是
描述: 到达机场代码（IATA）。
默认值: 无
示例:
"SGN"
data.previousSegs[].depTime
类型: 字符串
必填: 是
描述: 出发时间，格式为
YYYY-MM-DD HH:MM:SS。默认值: 无
示例:
"2023-07-24 19:50:00"
data.previousSegs[].arrTime
类型: 字符串
必填: 是
描述: 到达时间，格式为
YYYY-MM-DD HH:MM:SS。默认值: 无
示例:
"2023-07-24 21:30:00"
data.previousSegs[].carrier
类型: 字符串
必填: 是
描述: 航司代码。
默认值: 无
示例:
"VJ"
data.previousSegs[].flightNumber
类型: 字符串
必填: 是
描述: 航司分配的航班号。
默认值: 无
示例:
"VJ877"
data.previousSegs[].depTerminal
类型: 字符串
必填: 否
描述: 出发航站楼信息。
默认值:
""示例:
""
data.previousSegs[].arrTerminal
类型: 字符串
必填: 否
描述: 到达航站楼信息。
默认值:
""示例:
""
data.previousSegs[].direction
类型: 整数
必填: 是
描述: 1 表示去程航段，2 表示回程航段。
默认值: 无
示例:
1
data.revisedSegs
类型: 对象数组
必填: 是
描述: 包含日程变更后的航班航段详情。如果
data.scheduleChangeType指示航班取消，此节点应为空数组（即没有受保护的航班）。默认值: 无
data.revisedSegs[]
类型: Object
必填: 是
描述: 日程变更后的单个航班航段详情。
示例:
data.originalSegs
类型: 对象数组
必填: 是
描述: 包含任何日程变更前的原始航班航段详情。出票后可能会发生多次日程变更，此节点用于显示旅客预订机票时的航班航段详情。
默认值: 无
data.originalSegs[]
类型: Object
必填: 是
描述: 旅客预订机票时的单个航班航段详情。
示例:
相关页面
Last updated
Was this helpful?