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

presaleAncillaryShopping 售前辅营搜索接口

POST
/api/new/presaleAncillaryShopping.do
调用presaleAncillaryShopping,搜索可用的售前辅营信息。
售前定义:机票生单前。

请求参数

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
必需
示例
{
    "authentication": {
        "sign": "{{sign}}",
        "timestamp": "{{timestamp}}"
    },
    "offerId": "18599007684923392"
}

示例代码

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/presaleAncillaryShopping.do' \
--header 'Accept-Encoding;' \
--header 'appKey;' \
--header 'content-Type: application/json' \
--data-raw '{
    "authentication": {
        "sign": "",
        "timestamp": ""
    },
    "offerId": "18599007684923392"
}'

返回响应

🟢200OK
application/json
Body
traceId
string 
追溯码
必需
code
string 
状态码
必需
000000 代表成功,其他代表失败
message
string 
状态说明
必需
processingTime
number 
处理时长
必需
单位:ms
>= 0
data
object (辅营行李响应) 
返回的所有数据
必需
当code为”失败“时,内容为空
currency
string 
币种
必需
auxes
array[object (航段可添加辅营报价信息) {10}] 
航段可添加辅营报价信息
必需
segments
array [object {16}] 
航段信息
必需
示例
{
    "traceId": "preAuxQuery_NEWAPI250117114603303089",
    "code": "000000",
    "message": "成功",
    "processingTime": 309,
    "data": {
        "currency": "CNY",
        "auxes": [
            {
                "segmentIds": [
                    "4453068fd343a3eb89b823fc48cc2cd9"
                ],
                "auxId": "e59705c27c684477bee39a55dd84b245SINHKG",
                "baseFare": 7757,
                "serviceFee": 0,
                "size": "e",
                "piece": 1,
                "weight": 20,
                "limitPerPax": null,
                "availability": null,
                "bagType": "CHECK_IN"
            },
            {
                "segmentIds": [
                    "4453068fd343a3eb89b823fc48cc2cd9"
                ],
                "auxId": "e1e0a9ce86554e2ea7bda4202daf318bSINHKG",
                "baseFare": 5823,
                "serviceFee": 0,
                "size": "e",
                "piece": 1,
                "weight": 10,
                "limitPerPax": null,
                "availability": null,
                "bagType": "CHECK_IN"
            },
            {
                "segmentIds": [
                    "4453068fd343a3eb89b823fc48cc2cd9"
                ],
                "auxId": "076ed7e3d8a0450b9ef5ffb15cf91665SINHKG",
                "baseFare": 3889,
                "serviceFee": 0,
                "size": "e",
                "piece": 1,
                "weight": 15,
                "limitPerPax": null,
                "availability": null,
                "bagType": "CHECK_IN"
            },
            {
                "segmentIds": [
                    "4453068fd343a3eb89b823fc48cc2cd9"
                ],
                "auxId": "42a4d566b7ab431c89eb34724031eea5SINHKG",
                "baseFare": 1955,
                "serviceFee": 0,
                "size": "e",
                "piece": 1,
                "weight": 5,
                "limitPerPax": null,
                "availability": null,
                "bagType": "CHECK_IN"
            }
        ],
        "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
            }
        ]
    }
}
修改于 2025-06-12 09:37:10
上一页
orderDetail 订单详情接口
下一页
postsaleAncillaryShopping 售后行李搜索接口
Built with