AncillarySeat

  • 用途：用于出票后根据 AeroHub 机票订单查询供应商收费座位及价格。
  • 请求方式：POST
  • 接口加密：否

请求参数

参数名称 类型 必填 说明
requestId string ✅ 请求 ID，每次调用保持唯一，长度 32 位。
orderNo string ⬜ AeroHub 机票订单号。
isCache int ⬜ 是否使用缓存数据：为空或 0 表示不使用缓存，1 表示使用缓存。
adultNumber int ✅ 成人乘客数量。
childNumber int ⬜ 儿童乘客数量。
infantNumber int ⬜ 婴儿乘客数量。
segments array/Segment Element ✅ 行程信息。

array/Segment Element

参数名称 类型 必填 说明
depAirport string ✅ 出发机场代码，采用 IATA 三字代码作为标准。
arrAirport string ✅ 到达机场代码，采用 IATA 三字代码作为标准。
flightNumber string ✅ 航班号，例如 5J378。
segmentNo int ✅ 航程顺序：1 去程、2 回程。
sequence int ✅ 航段顺序，从 1 开始；往返行程的去程和回程分别从 1 开始。
depDate string ✅ 起飞日期，格式为 YYYYMMDD，例如 20240710。

请求示例：

{
  "requestId": "74e155e75f9d4a33866cbd1234567890",
  "orderNo": "F123123123111121",
  "isCache": 0,
  "adultNumber": 1,
  "childNumber": 0,
  "infantNumber": 0,
  "segments": [
    {
      "depAirport": "CGY",
      "arrAirport": "MNL",
      "flightNumber": "5J378",
      "segmentNo": 1,
      "sequence": 1,
      "depDate": "20240710"
    }
  ]
}

返回参数

参数名称 类型 必填 说明
marketErrorCode int ✅ 供应商系统错误码，用于协助 AeroHub 与供应商排查问题，请返回真实错误码。
marketErrorMsg string ✅ 供应商系统错误描述，请返回真实错误原因，长度小于 300 个字符。
flights array/Flights Element ✅ 航段及座位信息。

array/Flights Element

参数名称 类型 必填 说明
flightNumber string ✅ 航班号，例如 5J378。
seats array/Seats Element ✅ 当前航段的座位信息。没有可售座位时返回空数组。

array/Seats Element

参数名称 类型 必填 说明
amount float ✅ 选座价格；金额为 0 表示套餐中包含的免费选座。
currency string ✅ 交易币种。
rowNo string ✅ 座位行号。
colNo string ✅ 座位列号。
data string ✅ 供应商返回的原始串联数据，用于内部业务关联，长度不超过 64 位。
deck string ✅ 客舱层级：M 主舱下层，U 上层客舱。
status int ✅ 座位状态：0 不可选，1 可选。
nearAisle int ✅ 是否靠走廊：0 未知、1 是、2 否。
nearExit int ✅ 是否靠出口：0 未知、1 是、2 否。
nearLavatory int ✅ 是否靠洗手间：0 未知、1 是、2 否。
nearWindow int ✅ 是否靠窗：0 未知、1 是、2 否。
overWing int ✅ 是否位于机翼区域：0 未知、1 是、2 否。
allowChildSelected int ⬜ 是否允许儿童选择：0 未知、1 是、2 否。
withInfant int ⬜ 当前座位是否允许携带婴儿：0 未知、1 是、2 否。

成功响应示例：

{
  "marketErrorCode": 200,
  "marketErrorMsg": "Successful",
  "flights": [
    {
      "flightNumber": "5J378",
      "seats": [
        {
          "amount": 29.32,
          "currency": "USD",
          "rowNo": "12",
          "colNo": "A",
          "data": "supplier-seat-token",
          "deck": "M",
          "status": 1,
          "nearAisle": 0,
          "nearExit": 0,
          "nearLavatory": 0,
          "nearWindow": 1,
          "overWing": 0,
          "allowChildSelected": 1,
          "withInfant": 0
        }
      ]
    }
  ]
}
Author：AeroHub  Create time：2026-10-19 18:56
Last editor：AeroHub  Update time：2026-10-20 11:34