SSR

  • 用途：通过本接口可获取到供应商收费辅营的价格，包含托运行李、登机行李、快速登机等
  • 请求方式：POST
  • 接口加密：否

请求参数

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

array/Segment Element

参数名称 类型 必填 说明
depAirport string ✅ 出发机场代码，采用 IATA 三字代码做为标准
arrAirport string ✅ 到达机场代码，采用 IATA 三字代码做为标准
flightNumber string ✅ 航班号，如：CA123
depDate str ✅ 起飞日期，格式：YYYYMMDD，例如20230310 表示2023年3月10日

请求示例

{
    "requestId": "c0b0afec7ddd81a9cb3aa85713d39f36",
    "sessionId": "c80fbf1a15da1eceeeb70bb6e53105e9gvn52123",
    "segments": [{
        "depAirport": "CGY",
        "arrAirport": "MNL",
        "flightNumber": "5J378",
        "depDate": "20240710"
    }]
}

返回参数

参数名称 类型 必填 说明
marketErrorCode int ✅ 供应商系统错误码，用于协助AeroHub与供应商排查问题，请如实返回真实错误
marketErrorMsg string ✅ 供应商系统错误描述，请如实返回真实错误原因，长度小于 300
flights array/flights Element ✅ 行程与行李信息

array/flights Element

参数名称 类型 必填 说明
ssrs array/ssrs Element ✅ 航段的行李信息
flightNumber string ✅ 航班号，如：CA123
isDirect bool ✅ 行李是否直达，true 直达、false 非直达，需要重新办理托运

array/ssrs Element

参数名称 类型 必填 说明
applyType int ✅ 辅营类型，1 预定时、 2 预定后
name string ✅ 辅营名称,必须为字母、数字或者两者组合，不支持其他字符格式
code string ✅ 辅营代码，规则参考本文档的SSR Code Enum
type int ✅ 辅营类型，0 托运行李、1 登机行李、2 值机、3 登机行李+优先登机套餐
bookSalePrice float ✅ 辅营价格，保留2位小数
currency string ✅ 辅营币种，应与机票一致
weight int ✅ 行李重量，未知或没有可赋值0
dimensions object/dimensions Element ⬜️ 辅营的规格型号
unit string ✅ 辅营的计量单位，行李请传递KG，值机和快速登机请传递PC
desc string ✅ 针对辅营的说明，没有请传空字符串
maxCount int ⬜ 辅营的最大的可购买数量
weightChargeType string ⬜ 辅营的重量对应的类型，”TOTAL”-表示返回的行李重量是总额,”PER_WEIGHT”-表示返回的行李重量是单件

object/dimensions Element

参数名称 类型 必填 说明
length int ✅ 辅营的长度
width int ✅ 辅营的宽度
height int ✅ 辅营的高度

返回示例

Success-Response:

{
    "marketErrorCode": 200,
    "marketErrorMsg": "Successful",
    "flights": [{
        "ssrs": [{
            "applyType": 1,
            "name": "40 KG",
            "code": "PA40",
            "type": 0,
            "bookSalePrice": 38.86,
            "currency": "USD",
            "weight": 40,
            "dimensions": {
                "length": 10,
                "width": 5,
                "height": 2
            },
            "unit": "KG",
            "desc": ""
        }, {
            "applyType": 1,
            "name": "25 KG",
            "code": "PA25",
            "type": 0,
            "bookSalePrice": 22.4,
            "currency": "USD",
            "weight": 25,
            "dimensions": {
                "length": 10,
                "width": 5,
                "height": 2
            },
            "unit": "KG",
            "desc": ""
        }],
        "flightNumber": "DD133",
        "isDirect": true
    }]
}

SSR Code Enum

  • 行李的重量与代码一起指定（ 例如PA20表示20公斤，若航司没有重量规格，则传递PA00 ）
代码 示例 定义 描述
PA+重量 PA20 预订中托运行李 该代码用于乘客在预订时添加托运行李
PB+重量 PB15 预订后托运行李 该代码用于乘客在预订后添加托运行李
CA+重量 CA10 预订中登机行李 该代码用于乘客在预订中添加登机（随身携带）行李
CB+重量 CB10 预订后登机行李 该代码用于乘客在预订后添加登机（随身携带）行李
PE00 PE00 预订中快速登机 该代码表示在预订时添加快速登机，若快速登机和登机行李等其他辅营一起打包，则要按快速登机传值（例如：PE00）
PS00 PS00 预订后快速登机 该代码表示在预订后添加快速登机，若快速登机和登机行李等其他辅营一起打包，则要按快速登机传值（例如：PS00）
Author：AeroHub  Create time：2023-11-10 17:01
Last editor：AeroHub  Update time：2025-10-28 15:50