ScheduleChange

  • 用途：此接口用于接收供应商航班变更通知，包括航班延误、取消、变更等信息。
  • 请求方式：POST
  • 接口加密：否
  • FareMarket地址：/supplier/v1/api/schedule_change

请求参数

参数名称 类型 必填 说明
apiKey string ✅ 每个供应商有自己唯一的apiKey，用于表示供应商身份，AeroHub在接口测试前提供给供应商
requestId string ✅ 请求ID，出票环节每个次调用是唯一的，长度32位
purchaseOrderNo string ✅ AeroHub的订单号
ticketNo string ⬜️ 票号，廉价航空若没有可和PNRCode一致
changedTime string ✅ 航变发生的时间，若不知晓可以传递接口调用时间，采用 ISO 8601 格式
changeType int ✅ 航变类型：1 航班取消、2 航班变更（含延误）
isChange bool ✅ 是否变更航程类型（如直飞变中转、中转变直飞）：true 变更、false 未变更
items array/items Element ✅ 航变信息

array/items Element

参数名称 类型 必填 说明
segmentNo int ✅ 航程顺序，1 去程、2 回程
originalSegments array/originalSegments Element ✅ 行程信息
changedSegments array/changedSegments Element ⬜️ 行程信息，注意，只有在航变时需要返回
array/originalSegments Element
参数名称 类型 必填 说明
flightNumber string ✅ 航班号，如：CA123
depAirport string ✅ 出发机场代码，采用 IATA 三字代码做为标准
depTime string ✅ 起飞日期和起飞时间（当地时间），采用 ISO 8601 格式
arrAirport string ✅ 到达机场代码，采用 IATA 三字代码做为标准
arrTime string ✅ 到达日期和到达时间（当地时间），采用 ISO 8601 格式
array/changedSegments Element
参数名称 类型 必填 说明
flightNumber string ✅ 航班号，如：CA123
depAirport string ✅ 出发机场代码，采用 IATA 三字代码做为标准
depTime string ✅ 起飞日期和起飞时间（当地时间），采用 ISO 8601 格式
arrAirport string ✅ 到达机场代码，采用 IATA 三字代码做为标准
arrTime string ✅ 到达日期和到达时间（当地时间），采用 ISO 8601 格式

请求示例

{
    "apiKey": "PcrNq8964iFUkE0CyVV4bhgXXX",
    "requestId": "7a0091e344cc4a9886eafd4334d36bcb",
    "purchaseOrderNo": "F1783888564216623104",
    "ticketNo": "3DFCH0",
    "changedTime": "2024-05-07T15:28:28",
    "changeType": 2,
    "isChange": false,
    "items": [{
        "segmentNo": 1,
        "originalSegments": [{
            "flightNumber": "DD323",
            "depAirport": "UBP",
            "depTime": "2024-05-09T11:20",
            "arrAirport": "DMK",
            "arrTime": "2024-05-09T12:20"
            },
            {
            "flightNumber": "DD323",
            "depAirport": "UBP",
            "depTime": "2024-05-09T11:20",
            "arrAirport": "DMK",
            "arrTime": "2024-05-09T12:20"
            }],
        "changedSegments": [{
            "flightNumber": "DD323",
            "depAirport": "UBP",
            "depTime": "2024-05-09T11:30",
            "arrAirport": "DMK",
            "arrTime": "2024-05-09T12:30"
            }]
        }]
}

返回参数

参数名称 类型 必填 说明
code int ✅ AeroHub的状态码，参考通用说明中的Market Errors
msg string ✅ AeroHub的错误说明，参考通用说明中的Market Errors

返回示例

Success-Response:

{
    "code": 200,
    "msg": "Successful"
}

Error-Response

{
    "code": 400,
    "msg": "Failed"
}

注意事项

  • 请确保提供正确的预订编号和航班信息。
  • 时间应为ISO 8601格式。
  • sequence 若是往返，去程和回程都是从1开始。
  • changedSegments 只有在航变时需要返回。
Author：AeroHub  Create time：2024-03-13 11:33
Last editor：AeroHub  Update time：2025-10-28 15:50