航班变更通知

票务通知Webhook

一旦票务预订完成,您将在服务器上收到order.ticketed通知。您可以处理它并根据需要采取行动。例如,您可以向客户发送包含票务详情的预订确认邮件。

端点

您配置用于接收通知的URL

方法:Post

cid

  • 类型: 字符串

  • 必填:

  • 描述: 创建订单的用户ID

  • 默认值:

  • 示例: "XXXXXXX"

notificationId

  • 类型: 字符串

  • 必填:

  • 描述: 通知唯一ID

  • 默认值:

  • 示例: "20230917143240511TATVO"

status

  • 类型: 整数

  • 必填:

  • 描述: 通知事件状态. 枚举值:0: 未确认 1: 已确认

  • 默认值:

  • 示例: 0

type

  • 类型: 字符串

  • 必填:

  • 描述: 通知类型,对于航变来说,总是:order.schedulechange

  • 默认值:

  • 示例: "order.schedulechange"

data

  • 类型: 对象

  • 必填:

  • 描述: 包含历史航段、原始航段及修改后的航段。

  • 默认值:

  • 示例:

data.orderNo

  • 类型: 字符串

  • 必填:

  • 描述: 与该航班预订相关联的唯一订单号。

  • 默认值:

  • 示例: "ATXFQ20230720193244809"

data.scheduleChangeType

  • 类型: 整数

  • 必填:

  • 描述: 航变类型.

    枚举值:

    • 1: 航班变化

    • 2: 航班取消

  • 默认值:

  • 示例: 1

data.previousSegs

  • 类型: 对象数组

  • 必填:

  • 描述: 包含此次航班计划变更前的航段详情。

  • 默认值:

data.previousSegs[]

  • 类型: 对象

  • 必填:

  • 描述: 此次航班计划变更前的单个航段详情。

  • 示例:

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[]

  • 类型: 对象

  • 必填:

  • 描述: 航班计划变更后的单个航段详情。

  • 示例:

data.originalSegs

  • 类型: 对象数组

  • 必填:

  • 描述: 包含任意航班计划变更前的原始航段详情。出票后可能发生多次航变,该节点用于展示乘客预订机票时的航段详情。

  • 默认值:

data.originalSegs[]

  • 类型: 对象

  • 必填:

  • 描述: 乘客预订机票时的单个航段详情。

  • 示例:

Last updated

Was this helpful?