GetSeat

  • 用途：通过本接口可获取到供应商收费选座的价格
  • 请求方式：POST
  • 接口加密：否

请求参数

参数名称 类型 必填 说明
requestId string ✅ 请求ID，预订环节中的各个接口是唯一的，可通过本字段串联一个完整的预订流程，长度32位
sessionId string ✅ 会话标识，供应商在预定环节串联各个接口的唯一标识，由数字或字母组成，最大长度40字符
segments array/Segment Element ✅ 行程信息
adultNumber int ✅ 成人乘客的数量
childNumber int ⬜ 儿童乘客的数量
infantNumber int ⬜ 婴儿乘客的数量

array/Segment Element

参数名称 类型 必填 说明
depAirport string ✅ 出发机场代码，采用 IATA 三字代码做为标准
arrAirport string ✅ 到达机场代码，采用 IATA 三字代码做为标准
flightNumber string ✅ 航班号，如：CA123
segmentNo int ✅ 航程顺序，1 去程、2 回程
sequence int ✅ 航段顺序，从1开始，注意：若是往返，去程和回程都是从1开始
depDate string ✅ 起飞日期，格式：YYYYMMDD，例如20230310 表示2023年3月10日

请求示例

{
    "requestId": "c0b0afec7ddd81a9cb3aa85713d39f36",
    "sessionId": "c80fbf1a15da1eceeeb70bb6e53105e9gvn52123",
    "adultNumber": 1,
    "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

参数名称 类型 必填 说明
seats array/seats Element ✅ 航段的座位信息
flightNumber string ✅ 航班号，如：CA123

array/seats Element

参数名称 类型 必填 说明
amount float ✅ 选座的价格，金额为0，代表套餐中包含的免费选座
currency string ✅ 交易币种
rowNo string ✅ 座位图的行号
colNo string ✅ 座位图的列号
data string ✅ 返回的data原文，用于供应商做内部业务串联长度不超过64位
deck string ✅ M:MainDeck客舱下层；U:UpperDeck客舱上层。
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: 否

返回示例

Success-Response:

{
    "marketErrorCode": 200,
    "marketErrorMsg": "Successful",
    "flights": [{
        "flightNumber": "5J378",
        "seats": [
             {
                "amount": 0.0,
                "currency": "USD",
                "rowNo": "1",
                "colNo": "A",
                "data": "eyJzZXJ2aWNlQ29kZSI6ICJTVEZTIiwgI0=",
                "deck": "M",
                "status": 0,
                "nearAisle": 0,
                "nearExit": 0,
                "nearLavatory": 0,
                "nearWindow": 0,
                "overWing": 0,
                "allowChildSelected": 0,
                "withInfant": 0
            },
            {
                "amount": 29.32,
                "currency": "USD",
                "rowNo": "2",
                "colNo": "A",
                "data": "eyJzZXJ2aWNlQ29kZSI6IvdogIjI0OTAwIn0=",
                "deck": "M",
                "status": 1,
                "nearAisle": 0,
                "nearExit": 0,
                "nearLavatory": 0,
                "nearWindow": 0,
                "overWing": 0,
                "allowChildSelected": 0,
                "withInfant": 0
            },
            {
                "amount": 29.32,
                "currency": "USD",
                "rowNo": "3",
                "colNo": "A",
                "data": "eyJzZXJ2aWNlQ29kjI0OTAwIn0=",
                "deck": "M",
                "status": 1,
                "nearAisle": 0,
                "nearExit": 0,
                "nearLavatory": 0,
                "nearWindow": 0,
                "overWing": 0,
                "allowChildSelected": 0,
                "withInfant": 0
            },
            {
                "amount": 39.32,
                "currency": "USD",
                "rowNo": "1",
                "colNo": "B",
                "data": "eyJzZXJ2aWNlQ29kZZ2h0dpbI0OTAwIn0=",
                "deck": "U",
                "status": 1,
                "nearAisle": 0,
                "nearExit": 0,
                "nearLavatory": 0,
                "nearWindow": 0,
                "overWing": 0,
                "allowChildSelected": 0,
                "withInfant": 0
            }
        ]
    }]
}
Author：AeroHub  Create time：2024-09-11 11:22
Last editor：AeroHub  Update time：2025-10-28 15:50