FR24 OpenAPI
  1. API 参考
FR24 OpenAPI
  • FR24_API_V2.0
    • 指南
      • API调用流程
      • 介绍
      • 附录
      • 错误码
    • API 参考
      • OrderChangeInforming 订单信息变更通知
      • Shopping 航班搜索接口
        POST
      • Pricing 校验接口
        POST
      • Booking 生单接口
        POST
      • Ticketing 申请出票接口
        POST
      • OrderDetail 订单详情接口
        POST
      • PresaleAncillaryShopping 售前辅营搜索接口
        POST
      • PostsaleAncillaryShopping 售后行李搜索接口
        POST
      • seatMap 机型图接口
        POST
      • AncillaryBooking 辅营生单接口
        POST
      • AncillaryPurchase 辅营支付接口
        POST
      • AncillaryOrderDetail 辅营订单详情
        POST
      • ChangeReshop 改期搜索接口
        POST
      • ReissueRequest 改期申请接口
        POST
      • RefundRequest 退票申请接口
        POST
      • RefundConfirming 退票确认接口
        POST
      • VoidRequest 废票提交接口
        POST
      • FileUpload 文件上传
        POST
      • SelectBalance 余额查询接口
        POST
    • 关于我们
      • API 能力
      • 商务合作
      • 门户网站
  1. API 参考

seatMap 机型图接口

开发中
POST
/api/new/seatMap.do
该接口为机型图接口,机票生单前(售前)或机票生单后(售后),通过调用该接口,获取当前订单对应的机型图情况以便乘客选座。

请求参数

Header 参数
Accept-Encoding
string 
必需
使用gzip压缩格式
默认值:
gzip, deflate, br
content-Type
string 
响应格式
必需
默认值:
application/json
appKey
string 
用户账户
必需
默认值:
{{appKey}}
Body 参数application/json
authentication
object 
用户认证信息
必需
sign
string 
签名
必需
appkey + appsecret + timestamp加密后的字符串,加密见附录
timestamp
string 
使用 unix 时间戳
必需
单位:秒
offerId
string 
机票offerId
可选
售前必填
orderNo
string 
机票订单号
可选
售后必填
bookType
enum<string> 
类型
必需
枚举值:
12
carrier
string 
航司
必需
segments
array [object {7}] 
航段信息
必需
segmentId
string 
航段唯一表示
必需
carrier
string 
销售航司
必需
使用IATA航司标准二字代码
flightNo
string 
航班号
必需
和carrier搭配使用
BA1234,carrier为BA,flightNo为1234
depAirport
string 
出发机场
必需
使用IATA机场标准三字代码
arrAirport
string 
到达机场
必需
使用IATA机场标准三字代码
depTime
string 
出发时间
必需
格式:YYYY-MM-DDThh:mm, 比如2022-10-21T21:23
cabin
string 
舱位
必需
passengers
array [object {2}] 
乘客信息
必需
paxType
enum<string> 
乘客类型
必需
枚举值:
ADTCHDINF
count
integer 
乘客人数
必需
示例
{
  "authentication": {
    "sign": "{{sign}}",
    "timestamp": "{{timestamp}}"
  },
  "bookType": "1",
  "offerId": "18599007684923392",
  "orderNo": "18599020016177152",
  "carrier": "CX",
  "segments": [
    {
      "segmentId": "4453068fd343a3eb89b823fc48cc2cd9",
      "flightNo": "636",
      "depAirport": "SIN",
      "arrAirport": "HKG",
      "cabin": "Y",
      "depTime": "2025-04-15T20:10"
    }
  ],
  "passengers": [
    {
      "count": "1",
      "paxType": "ADT"
    }
  ]
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://flight-test.flightroutes24.com/api/new/seatMap.do' \
--header 'Accept-Encoding;' \
--header 'appKey;' \
--header 'content-Type: application/json' \
--data-raw '{
    "authentication": {
        "sign": "",
        "timestamp": ""
    },
    "bookType": "1",
    "offerId": "18599007684923392",
    "orderNo": "18599020016177152",
    "carrier": "CX",
    "segments": [
        {
            "segmentId": "4453068fd343a3eb89b823fc48cc2cd9",
            "flightNo": "636",
            "depAirport": "SIN",
            "arrAirport": "HKG",
            "cabin": "Y",
            "depTime": "2025-04-15T20:10"
        }
    ],
    "passengers": [
        {
            "count": "1",
            "paxType": "ADT"
        }
    ]
}'

返回响应

🟢200OK
application/json
Body
traceId
string 
追溯码
必需
code
string 
状态码
必需
000000 代表成功,其他代表失败
message
string 
状态说明
必需
processingTime
number 
处理时长
必需
单位:ms
>= 0
data
object 
返回的所有数据
可选
当code为”失败“时,内容为空
currency
string 
币种
必需
segmentSeats
array [object {8}] 
所有航段选座信息
必需
示例
{
  "traceId": "NEWAPI2501171148278200811",
  "code": "000000",
  "message": "成功",
  "processingTime": 307,
  "data": {
    "currency": "CNY",
    "segmentSeats": [
      {
        "segmentId": null,
        "carrier": "CX",
        "flightNo": "636",
        "depAirport": "SIN",
        "arrAirport": "HKG",
        "cabin": "Y",
        "depTime": "2025-04-15T20:10",
        "seats": [
          {
            "rowNo": "18",
            "cols": [
              {
                "colNo": "A",
                "status": 1,
                "deck": "M",
                "position": "W",
                "seatPrice": 13
              },
              {
                "colNo": "B",
                "status": 0,
                "deck": "M",
                "position": "C",
                "seatPrice": 0
              },
              {
                "colNo": "C",
                "status": 1,
                "deck": "M",
                "position": "A",
                "seatPrice": 11
              },
              {
                "colNo": "D",
                "status": 1,
                "deck": "M",
                "position": "A",
                "seatPrice": 11
              },
              {
                "colNo": "E",
                "status": 0,
                "deck": "M",
                "position": "C",
                "seatPrice": 0
              },
              {
                "colNo": "F",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 11
              },
              {
                "colNo": "G",
                "status": 1,
                "deck": "M",
                "position": "W",
                "seatPrice": 13
              }
            ]
          },
          {
            "rowNo": "19",
            "cols": [
              {
                "colNo": "A",
                "status": 1,
                "deck": "M",
                "position": "W",
                "seatPrice": 13
              },
              {
                "colNo": "B",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 11
              },
              {
                "colNo": "C",
                "status": 1,
                "deck": "M",
                "position": "A",
                "seatPrice": 11
              },
              {
                "colNo": "D",
                "status": 1,
                "deck": "M",
                "position": "A",
                "seatPrice": 11
              },
              {
                "colNo": "E",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 11
              },
              {
                "colNo": "F",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 11
              },
              {
                "colNo": "G",
                "status": 1,
                "deck": "M",
                "position": "W",
                "seatPrice": 13
              }
            ]
          },
          {
            "rowNo": "20",
            "cols": [
              {
                "colNo": "A",
                "status": 0,
                "deck": "M",
                "position": "W",
                "seatPrice": 0
              },
              {
                "colNo": "B",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 6
              },
              {
                "colNo": "C",
                "status": 1,
                "deck": "M",
                "position": "A",
                "seatPrice": 6
              },
              {
                "colNo": "D",
                "status": 1,
                "deck": "M",
                "position": "A",
                "seatPrice": 6
              },
              {
                "colNo": "E",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 6
              },
              {
                "colNo": "F",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 6
              },
              {
                "colNo": "G",
                "status": 1,
                "deck": "M",
                "position": "W",
                "seatPrice": 11
              }
            ]
          },
          {
            "rowNo": "21",
            "cols": [
              {
                "colNo": "A",
                "status": 1,
                "deck": "M",
                "position": "W",
                "seatPrice": 11
              },
              {
                "colNo": "B",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 6
              },
              {
                "colNo": "C",
                "status": 0,
                "deck": "M",
                "position": "A",
                "seatPrice": 0
              },
              {
                "colNo": "D",
                "status": 0,
                "deck": "M",
                "position": "A",
                "seatPrice": 0
              },
              {
                "colNo": "E",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 6
              },
              {
                "colNo": "F",
                "status": 0,
                "deck": "M",
                "position": "C",
                "seatPrice": 0
              },
              {
                "colNo": "G",
                "status": 1,
                "deck": "M",
                "position": "W",
                "seatPrice": 11
              }
            ]
          },
          {
            "rowNo": "22",
            "cols": [
              {
                "colNo": "A",
                "status": 1,
                "deck": "M",
                "position": "W",
                "seatPrice": 8
              },
              {
                "colNo": "B",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 6
              },
              {
                "colNo": "C",
                "status": 1,
                "deck": "M",
                "position": "A",
                "seatPrice": 6
              },
              {
                "colNo": "D",
                "status": 1,
                "deck": "M",
                "position": "A",
                "seatPrice": 6
              },
              {
                "colNo": "E",
                "status": 0,
                "deck": "M",
                "position": "C",
                "seatPrice": 0
              },
              {
                "colNo": "F",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 6
              },
              {
                "colNo": "G",
                "status": 1,
                "deck": "M",
                "position": "W",
                "seatPrice": 8
              }
            ]
          },
          {
            "rowNo": "23",
            "cols": [
              {
                "colNo": "A",
                "status": 1,
                "deck": "M",
                "position": "W",
                "seatPrice": 10
              },
              {
                "colNo": "B",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 6
              },
              {
                "colNo": "C",
                "status": 0,
                "deck": "M",
                "position": "A",
                "seatPrice": 0
              },
              {
                "colNo": "D",
                "status": 1,
                "deck": "M",
                "position": "A",
                "seatPrice": 6
              },
              {
                "colNo": "E",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 6
              },
              {
                "colNo": "F",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 6
              },
              {
                "colNo": "G",
                "status": 1,
                "deck": "M",
                "position": "W",
                "seatPrice": 10
              }
            ]
          },
          {
            "rowNo": "24",
            "cols": [
              {
                "colNo": "A",
                "status": 1,
                "deck": "M",
                "position": "W",
                "seatPrice": 11
              },
              {
                "colNo": "B",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 8
              },
              {
                "colNo": "C",
                "status": 1,
                "deck": "M",
                "position": "A",
                "seatPrice": 8
              },
              {
                "colNo": "D",
                "status": 1,
                "deck": "M",
                "position": "A",
                "seatPrice": 8
              },
              {
                "colNo": "E",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 8
              },
              {
                "colNo": "F",
                "status": 0,
                "deck": "M",
                "position": "C",
                "seatPrice": 0
              },
              {
                "colNo": "G",
                "status": 0,
                "deck": "M",
                "position": "W",
                "seatPrice": 0
              }
            ]
          },
          {
            "rowNo": "25",
            "cols": [
              {
                "colNo": "A",
                "status": 1,
                "deck": "M",
                "position": "W",
                "seatPrice": 12
              },
              {
                "colNo": "B",
                "status": 0,
                "deck": "M",
                "position": "C",
                "seatPrice": 0
              },
              {
                "colNo": "C",
                "status": 1,
                "deck": "M",
                "position": "A",
                "seatPrice": 8
              },
              {
                "colNo": "D",
                "status": 1,
                "deck": "M",
                "position": "A",
                "seatPrice": 8
              },
              {
                "colNo": "E",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 8
              },
              {
                "colNo": "F",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 8
              },
              {
                "colNo": "G",
                "status": 1,
                "deck": "M",
                "position": "W",
                "seatPrice": 12
              }
            ]
          },
          {
            "rowNo": "26",
            "cols": [
              {
                "colNo": "A",
                "status": 1,
                "deck": "M",
                "position": "W",
                "seatPrice": 11
              },
              {
                "colNo": "B",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 8
              },
              {
                "colNo": "C",
                "status": 1,
                "deck": "M",
                "position": "A",
                "seatPrice": 8
              },
              {
                "colNo": "D",
                "status": 1,
                "deck": "M",
                "position": "A",
                "seatPrice": 8
              },
              {
                "colNo": "E",
                "status": 0,
                "deck": "M",
                "position": "C",
                "seatPrice": 0
              },
              {
                "colNo": "F",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 8
              },
              {
                "colNo": "G",
                "status": 1,
                "deck": "M",
                "position": "W",
                "seatPrice": 11
              }
            ]
          },
          {
            "rowNo": "27",
            "cols": [
              {
                "colNo": "A",
                "status": 0,
                "deck": "M",
                "position": "O",
                "seatPrice": 0
              },
              {
                "colNo": "B",
                "status": 0,
                "deck": "M",
                "position": "C",
                "seatPrice": 0
              },
              {
                "colNo": "C",
                "status": 0,
                "deck": "M",
                "position": "A",
                "seatPrice": 0
              },
              {
                "colNo": "D",
                "status": 1,
                "deck": "M",
                "position": "A",
                "seatPrice": 8
              },
              {
                "colNo": "E",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 8
              },
              {
                "colNo": "F",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 8
              },
              {
                "colNo": "G",
                "status": 0,
                "deck": "M",
                "position": "O",
                "seatPrice": 0
              }
            ]
          },
          {
            "rowNo": "28",
            "cols": [
              {
                "colNo": "A",
                "status": 1,
                "deck": "M",
                "position": "W",
                "seatPrice": 21
              },
              {
                "colNo": "B",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 17
              },
              {
                "colNo": "C",
                "status": 1,
                "deck": "M",
                "position": "A",
                "seatPrice": 17
              },
              {
                "colNo": "D",
                "status": 0,
                "deck": "M",
                "position": "A",
                "seatPrice": 0
              },
              {
                "colNo": "E",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 17
              },
              {
                "colNo": "F",
                "status": 0,
                "deck": "M",
                "position": "C",
                "seatPrice": 0
              },
              {
                "colNo": "G",
                "status": 1,
                "deck": "M",
                "position": "W",
                "seatPrice": 21
              }
            ]
          },
          {
            "rowNo": "29",
            "cols": [
              {
                "colNo": "A",
                "status": 0,
                "deck": "M",
                "position": "W",
                "seatPrice": 0
              },
              {
                "colNo": "B",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 17
              },
              {
                "colNo": "C",
                "status": 0,
                "deck": "M",
                "position": "A",
                "seatPrice": 0
              },
              {
                "colNo": "D",
                "status": 1,
                "deck": "M",
                "position": "A",
                "seatPrice": 17
              },
              {
                "colNo": "E",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 17
              },
              {
                "colNo": "F",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 17
              },
              {
                "colNo": "G",
                "status": 1,
                "deck": "M",
                "position": "W",
                "seatPrice": 22
              }
            ]
          },
          {
            "rowNo": "30",
            "cols": [
              {
                "colNo": "A",
                "status": 0,
                "deck": "M",
                "position": "W",
                "seatPrice": 0
              },
              {
                "colNo": "B",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 17
              },
              {
                "colNo": "C",
                "status": 1,
                "deck": "M",
                "position": "A",
                "seatPrice": 17
              },
              {
                "colNo": "D",
                "status": 0,
                "deck": "M",
                "position": "A",
                "seatPrice": 0
              },
              {
                "colNo": "E",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 17
              },
              {
                "colNo": "F",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 17
              },
              {
                "colNo": "G",
                "status": 1,
                "deck": "M",
                "position": "W",
                "seatPrice": 22
              }
            ]
          },
          {
            "rowNo": "31",
            "cols": [
              {
                "colNo": "A",
                "status": 1,
                "deck": "M",
                "position": "W",
                "seatPrice": 22
              },
              {
                "colNo": "B",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 17
              },
              {
                "colNo": "C",
                "status": 1,
                "deck": "M",
                "position": "A",
                "seatPrice": 17
              },
              {
                "colNo": "D",
                "status": 1,
                "deck": "M",
                "position": "A",
                "seatPrice": 17
              },
              {
                "colNo": "E",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 17
              },
              {
                "colNo": "F",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 17
              },
              {
                "colNo": "G",
                "status": 1,
                "deck": "M",
                "position": "W",
                "seatPrice": 22
              }
            ]
          },
          {
            "rowNo": "32",
            "cols": [
              {
                "colNo": "A",
                "status": 1,
                "deck": "M",
                "position": "W",
                "seatPrice": 13
              },
              {
                "colNo": "B",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 9
              },
              {
                "colNo": "C",
                "status": 1,
                "deck": "M",
                "position": "A",
                "seatPrice": 9
              },
              {
                "colNo": "D",
                "status": 1,
                "deck": "M",
                "position": "A",
                "seatPrice": 9
              },
              {
                "colNo": "E",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 9
              },
              {
                "colNo": "F",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 9
              },
              {
                "colNo": "G",
                "status": 1,
                "deck": "M",
                "position": "W",
                "seatPrice": 13
              }
            ]
          },
          {
            "rowNo": "33",
            "cols": [
              {
                "colNo": "A",
                "status": 0,
                "deck": "M",
                "position": "W",
                "seatPrice": 0
              },
              {
                "colNo": "B",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 9
              },
              {
                "colNo": "C",
                "status": 1,
                "deck": "M",
                "position": "A",
                "seatPrice": 9
              },
              {
                "colNo": "D",
                "status": 1,
                "deck": "M",
                "position": "A",
                "seatPrice": 9
              },
              {
                "colNo": "E",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 9
              },
              {
                "colNo": "F",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 9
              },
              {
                "colNo": "G",
                "status": 1,
                "deck": "M",
                "position": "W",
                "seatPrice": 14
              }
            ]
          },
          {
            "rowNo": "34",
            "cols": [
              {
                "colNo": "A",
                "status": 1,
                "deck": "M",
                "position": "W",
                "seatPrice": 14
              },
              {
                "colNo": "B",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 9
              },
              {
                "colNo": "C",
                "status": 1,
                "deck": "M",
                "position": "A",
                "seatPrice": 9
              },
              {
                "colNo": "D",
                "status": 1,
                "deck": "M",
                "position": "A",
                "seatPrice": 9
              },
              {
                "colNo": "E",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 9
              },
              {
                "colNo": "F",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 9
              },
              {
                "colNo": "G",
                "status": 1,
                "deck": "M",
                "position": "W",
                "seatPrice": 14
              }
            ]
          },
          {
            "rowNo": "35",
            "cols": [
              {
                "colNo": "A",
                "status": 0,
                "deck": "M",
                "position": "O",
                "seatPrice": 0
              },
              {
                "colNo": "B",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 9
              },
              {
                "colNo": "C",
                "status": 1,
                "deck": "M",
                "position": "A",
                "seatPrice": 9
              },
              {
                "colNo": "D",
                "status": 1,
                "deck": "M",
                "position": "A",
                "seatPrice": 9
              },
              {
                "colNo": "E",
                "status": 0,
                "deck": "M",
                "position": "C",
                "seatPrice": 0
              },
              {
                "colNo": "F",
                "status": 1,
                "deck": "M",
                "position": "C",
                "seatPrice": 9
              },
              {
                "colNo": "G",
                "status": 0,
                "deck": "M",
                "position": "O",
                "seatPrice": 0
              }
            ]
          }
        ]
      }
    ],
    "exchangeRate": 1
  }
}
修改于 2025-01-20 08:27:43
上一页
PostsaleAncillaryShopping 售后行李搜索接口
下一页
AncillaryBooking 辅营生单接口
Built with