AncillaryBooking 辅营生单接口

请求参数

Header 参数

Accept-Encoding

string

必需

使用gzip压缩格式

默认值:

gzip, deflate, br

content-Type

string

响应格式

必需

默认值:

application/json

appKey

string

用户账户

必需

默认值:

Body 参数application/json

authentication

object

用户认证信息

必需

sign

string

签名

必需

appkey + appsecret + timestamp加密后的字符串，加密见附录

timestamp

string

使用 unix 时间戳

必需

单位：秒

orderNo

string

FR24机票订单号

必需

如果已在FR24生单，则填写该订单

正则匹配:

^\d*$

partnerOrderNo

string

合作方机票订单号

必需

ancillary

array[object (预定辅营详情) {7}]

预定详情

必需

paxId

string

乘客id

必需

若购买行李，该项为必填项

segmentIds

array[string]

航段id组合

必需

auxId

string

辅营id

必需

quantity

number

该乘客购买件数

必需

auxType

enum<integer>

辅营类型

必需

枚举值:

12

baggage

array [object {4}]

辅营行李信息

可选

auxType为 1 必传

seatInfos

array [object {6}]

辅营选座信息

可选

auxType为 2必传

passengers

array [object {2}]

乘客信息

必需

paxId

string

乘客id

必需

name

string

乘客姓名

必需

segments

array [object {16}]

航段信息

必需

segmentId

string

航段唯一标识

必需

duration

integer

航段总时长

必需

单位分钟

carrier

string

销售航司

必需

使用IATA航司标准二字代码

flightNo

string

航班号

必需

和carrier搭配使用
BA1234，carrier为BA，flightNo为1234

codeShare

boolean

航班共享标识

必需

true-代码共享
false-非代码共享

operatingCarrier

string

实际承运航司

可选

使用IATA航司标准二字代码

operatingFlightNo

string

实际承运航班号

可选

aircraftCode

string

机型

可选

使用IATA机型标准三字代码

depAirport

string

出发机场

必需

使用IATA机型标准三字代码

depTerminal

string

出发航站楼

可选

示例值:

T1

depTime

string <date-time>

出发时间

必需

格式：YYYY-MM-DDThh:mm
比如2022-10-21T21:23
起飞机场所在地时间

arrAirport

string

到达机场

必需

使用IATA机场标准三字代码

arrTerminal

string

到达航站楼

可选

示例值:

T2

arrTime

string <date-time>

到达时间

必需

格式：YYYY-MM-DDThh:mm
到达机场所在地时间

stopAirport

array[string]

经停机场

可选

使用IATA机场标准三字标准代码。若无经停则无数据内容

stopDuration

array[integer]

停留时长

可选

若无经停则无数据内容

示例

{
  "authentication": {
    "sign": "{{sign}}",
    "timestamp": "{{timestamp}}"
  },
  "orderNo": "18599020016177152",
  "partnerOrderNo": "",
  "ancillary": [
    {
      "paxId": 1,
      "segmentIds": [
        "4453068fd343a3eb89b823fc48cc2cd9"
      ],
      "auxId": "e59705c27c684477bee39a55dd84b245SINHKG",
      "quantity": 1
    }
  ],
  "passengers": [
    {
      "paxId": "1",
      "name": "VJKOX/SBLUE"
    }
  ],
  "segments": [
    {
      "segmentId": "4453068fd343a3eb89b823fc48cc2cd9",
      "duration": 255,
      "carrier": "CX",
      "flightNo": "636",
      "codeShare": false,
      "operatingCarrier": null,
      "operatingFlightNo": null,
      "aircraftCode": "333",
      "depAirport": "SIN",
      "depTerminal": "4",
      "depTime": "2025-04-15T20:10",
      "arrAirport": "HKG",
      "arrTerminal": "1",
      "arrTime": "2025-04-16T00:25",
      "stopAirport": null,
      "stopDuration": null
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://flight-test.flightroutes24.com/api/new/ancillaryBooking.do' \
--header 'Accept-Encoding;' \
--header 'appKey;' \
--header 'content-Type: application/json' \
--data-raw '{
    "authentication": {
        "sign": "",
        "timestamp": ""
    },
    "orderNo": "18599020016177152",
    "partnerOrderNo": "",
    "ancillary": [
        {
            "paxId": 1,
            "segmentIds": [
                "4453068fd343a3eb89b823fc48cc2cd9"
            ],
            "auxId": "e59705c27c684477bee39a55dd84b245SINHKG",
            "quantity": 1
        }
    ],
    "passengers": [
        {
            "paxId": "1",
            "name": "VJKOX/SBLUE"
        }
    ],
    "segments": [
        {
            "segmentId": "4453068fd343a3eb89b823fc48cc2cd9",
            "duration": 255,
            "carrier": "CX",
            "flightNo": "636",
            "codeShare": false,
            "operatingCarrier": null,
            "operatingFlightNo": null,
            "aircraftCode": "333",
            "depAirport": "SIN",
            "depTerminal": "4",
            "depTime": "2025-04-15T20:10",
            "arrAirport": "HKG",
            "arrTerminal": "1",
            "arrTime": "2025-04-16T00:25",
            "stopAirport": null,
            "stopDuration": null
        }
    ]
}'

返回响应

🟢200OK

application/json

Body

traceId

string

追溯码

必需

code

string

状态码

必需

000000 代表成功，其他代表失败

message

string

状态说明

必需

processingTime

number

处理时长

必需

单位：ms

>= 0

data

object (辅助生单响应)

返回的所有数据

可选

当code为”失败“时，内容为空

auxOrderNo

string

辅营订单号

必需

auxOrderStatus

string

订单状态

必需

partnerAuxOrderNo

string

合作方辅营订单号

可选

orderNo

string

FR24机票订单号

必需

createTime

string

订单创建时间

可选

格式：YYYY-MM-DDTHH:mm

currency

string

订单币种

必需

totalPrice

number

辅营订单总价

必需

ancillary

object (辅营信息)

辅营信息

必需

passengers

array [object {2}]

乘客信息

必需

segments

array [object {16}]

航段信息

必需

payDeadline

string

最晚支付时间

必需

格式：YYYY-MM-DDTHH:mm

示例

{
  "traceId": "auxOrder_NEWAPI2501171149428640812",
  "code": "000000",
  "message": "成功",
  "processingTime": 1729,
  "data": {
    "auxOrderNo": "18599058925555712",
    "auxOrderStatus": "1",
    "partnerAuxOrderNo": "",
    "orderNo": "18599020016177152",
    "createTime": null,
    "currency": "CNY",
    "totalPrice": 7757,
    "ancillary": {
      "baggage": [
        {
          "paxId": "1",
          "segmentIds": [
            "4453068fd343a3eb89b823fc48cc2cd9"
          ],
          "auxId": "e59705c27c684477bee39a55dd84b245SINHKG",
          "totalPrice": 7757,
          "baseFare": 7757,
          "serviceFee": 0,
          "size": "e",
          "piece": 1,
          "weight": 20,
          "quantity": 1,
          "type": "CHECK_IN"
        }
      ],
      "seatInfos": null
    },
    "passengers": [
      {
        "paxId": "1",
        "name": "VJKOX/SBLUE"
      }
    ],
    "segments": [
      {
        "segmentId": "4453068fd343a3eb89b823fc48cc2cd9",
        "duration": 255,
        "carrier": "CX",
        "flightNo": "636",
        "codeShare": false,
        "operatingCarrier": null,
        "operatingFlightNo": null,
        "aircraftCode": "333",
        "depAirport": "SIN",
        "depTerminal": "4",
        "depTime": "2025-04-15T20:10",
        "arrAirport": "HKG",
        "arrTerminal": "1",
        "arrTime": "2025-04-16T00:25",
        "stopAirport": null,
        "stopDuration": null
      }
    ],
    "payDeadline": null
  }
}