pricing 校验接口 - FR24 OpenAPI

通过调用pricing接口，合作方可以根据shopping返回结果提供的offerId、和实际需要购票的乘客类型及人数获取实时的价格和舱位信息。
仅可使用真实乘客预定数据，不支持使用pricing接口更新缓存，会根据协议判定校验生单转化率。

请求参数

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 时间戳

必需

单位：秒

offerId

string

shoppingRS返回的唯一标识offerId

必需

adultNum

integer

成人乘客数

必需

一个乘客最多带两个儿童或婴儿

>= 1<= 9

默认值:

childNum

integer

儿童乘客数

可选

>= 0<= 9

默认值:

infantNum

integer

婴儿乘客数

可选

>= 0<= 9

默认值:

seriesTraceId

string

上一个业务请求接口返回的traceId

可选

此字段为开发者选项，FR24通过此traceId追踪并分析合作商的上一个调用接口，方便双方在出现问题时能够快速追踪整条链路

seriesRsTime

number

上一个业务请求接口，从请求该接口到获取结果的时长

可选

单位为ms；此字段为开发者选项，FR24通过该时长分析合作商的网络延迟情况，以提升双方的数据质量。

示例

{
    "authentication": {
        "sign": "{{sign}}",
        "timestamp": "{{timestamp}}"
    },
    "offerId": "18599004604928000",
    "adultNum": 2,
    "childNum": 0,
    "infantNum": 0,
    "seriesTraceId": "queryFlight_NEWAPI250117113553863087",
    "seriesRsTime": 1717
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200OK

application/json

Body

traceId

string

追溯码

必需

code

string

状态码

必需

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

message

string

状态说明

必需

processingTime

number

处理时长

必需

单位：ms

>= 0

data

object

返回的所有数据

可选

当status为（失败）时，内容为空

offer

array [object {18}]

报价信息

必需

包含了直飞和中转所有的报价组合

legs

object (行程信息)

行程信息

必需

包含了所有航班组合

segments

array [object {16}]

航段信息

必需

包含了所有不重复的航班信息

示例

{
    "traceId": "verify_NEWAPI250117113637244071144",
    "code": "000000",
    "message": "成功",
    "processingTime": 5320,
    "data": {
        "offer": [
            {
                "offerId": "18599007684923392",
                "legId": "1ebb56358b1c617a18a597543feceb77",
                "currency": "CNY",
                "platingCarrier": "CX",
                "pricePerPax": [
                    {
                        "paxType": "ADT",
                        "baseFare": 581,
                        "totalTax": 493,
                        "taxBreakdown": [],
                        "serviceFee": 10000
                    }
                ],
                "cabin": [
                    "Y"
                ],
                "fareBasis": [
                    "QR21SGAO"
                ],
                "availability": [
                    "9"
                ],
                "extraInfo": {
                    "freeBaggageAllowance": [
                        {
                            "segmentId": "4453068fd343a3eb89b823fc48cc2cd9",
                            "cabinBagPc": "1-e-e",
                            "cabinBagSize": "e-e-e",
                            "cabinBagWeight": "7-e-e",
                            "checkedBagPc": "1-e-e",
                            "checkedBagSize": "e-e-e",
                            "checkedBagWeight": "e-e-e"
                        }
                    ]
                },
                "eligibilityFlag": false,
                "eligibilityDetail": null,
                "rules": {
                    "refund": [
                        {
                            "paxType": "ADT",
                            "couponStatus": 0,
                            "refundPolicy": "withCondition",
                            "applicableTime": [
                                null,
                                0
                            ],
                            "fullRefundAP": null,
                            "refundFee": 1539
                        },
                        {
                            "paxType": "ADT",
                            "couponStatus": 0,
                            "refundPolicy": "notAllowed",
                            "applicableTime": [
                                0,
                                null
                            ],
                            "fullRefundAP": null,
                            "refundFee": null
                        }
                    ],
                    "change": [
                        {
                            "paxType": "ADT",
                            "couponStatus": 0,
                            "changePolicy": "withCondition",
                            "applicableTime": [
                                null,
                                0
                            ],
                            "changeFee": 513
                        },
                        {
                            "paxType": "ADT",
                            "couponStatus": 0,
                            "changePolicy": "notAllowed",
                            "applicableTime": [
                                0,
                                null
                            ],
                            "changeFee": null
                        }
                    ]
                },
                "productType": null,
                "productTag": {
                    "ticketPromise": null,
                    "refuseDeadline": null,
                    "ticketingTime": null,
                    "reschedulePendingTime": null,
                    "voluntaryRefundTime": null,
                    "involuntaryRefundTime": null,
                    "refundCondition": null,
                    "reissueCondition": null,
                    "voidingCondition": false,
                    "voluntaryServiceStandard": null,
                    "involuntaryServiceStandard": null,
                    "rescheduleProcessingTime": null,
                    "productSupplier": null,
                    "RBDChangedRisk": false,
                    "fareBrand": [
                        ""
                    ],
                    "posArea": [
                        null
                    ]
                },
                "productSource": "OTH",
                "totalPrice": 22148,
                "paxInfoRequired": {
                    "birthday": true,
                    "gender": true,
                    "cardNum": false,
                    "cardType": false,
                    "cardIssuedPlace": false,
                    "cardExpiryDate": false,
                    "nationality": true,
                    "paxEmail": false,
                    "paxMobile": false,
                    "areaCode": false
                },
                "RBD": [
                    "Q"
                ]
            }
        ],
        "legs": {
            "legId": "1ebb56358b1c617a18a597543feceb77",
            "segmentIds": [
                "4453068fd343a3eb89b823fc48cc2cd9"
            ]
        },
        "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
            }
        ]
    }
}