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 参考

ancillaryBooking 辅营生单接口

POST
/api/new/ancillaryBooking.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 时间戳
必需
单位：秒
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 {7}] 
辅营选座信息
可选
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
请求示例请求示例
Shell
JavaScript
Java
Swift
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
    }
}
修改于 2025-06-12 09:37:21
上一页
seatMap 机型图接口
下一页
ancillaryPurchase 辅营支付接口
Built with