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

changeReshop 改期搜索接口

POST
/api/new/changeReshop.do
调用changeReshop搜索可改期的航班选择。

请求参数

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订单号
必需
正则匹配:
^\d*$
originalSegments
array[object (原始航段信息) {3}] 
原始航段信息
必需
carrier
string 
航司二字码
必需
flightNo
string 
航班号
必需
depTime
string <date-time>
出发时间
必需
格式:YYYY-MM-DDTHH:mm
newLegs
array[object (搜索航段信息) {5}] 
新的改期航段信息
必需
origin
string 
起飞城市
必需
使用IATA城市标准三字代码
>= 3 字符<= 3 字符
typeO
enum<string> 
对于origin类型限制
可选
枚举值:
airportcodeairportgroup
destination
string 
到达城市
必需
使用IATA城市标准三字代码
>= 3 字符<= 3 字符
typeD
enum<string> 
对于destination类型限制
可选
枚举值:
airportcodeairportgroup
depDate
string <date>
起飞日期
必需
格式:YYYY-MM-DD
>= 10 字符<= 10 字符
正则匹配:
^\d{4}-\d{2}-\d{2}$
adultNum
integer 
成人乘客人数
必需
childNum
integer 
儿童乘客人数
可选
infantNum
integer 
婴儿乘客人数
可选
preferences
object 
偏好
可选
cabin
enum<string> 
舱等偏好
可选
不填默认为原订单舱等
枚举值:
FCPY
示例
{
    "authentication": {
        "sign": "{{sign}}",
        "timestamp": "{{timestamp}}"
    },
    "orderNo": "18599172460974080",
    "originalSegments": [
        {
            "carrier": "CX",
            "flightNo": "636",
            "depTime": "2025-04-15T20:10"
        }
    ],
    "newLegs": [
        {
            "origin": "SIN",
            "destination": "HKG",
            "depDate": "2025-02-25"
        }
    ],
    "adultNum": 1,
    "childNum": 0,
    "infantNum": 0,
    "preferences": {
        "cabin": ""
    }
}

示例代码

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/changeReshop.do' \
--header 'Accept-Encoding;' \
--header 'appKey;' \
--header 'content-Type: application/json' \
--data-raw '{
    "authentication": {
        "sign": "",
        "timestamp": ""
    },
    "orderNo": "18599172460974080",
    "originalSegments": [
        {
            "carrier": "CX",
            "flightNo": "636",
            "depTime": "2025-04-15T20:10"
        }
    ],
    "newLegs": [
        {
            "origin": "SIN",
            "destination": "HKG",
            "depDate": "2025-02-25"
        }
    ],
    "adultNum": 1,
    "childNum": 0,
    "infantNum": 0,
    "preferences": {
        "cabin": ""
    }
}'

返回响应

🟢200OK
application/json
Body
traceId
string 
追溯码
必需
code
string 
状态码
必需
000000 代表成功,其他代表失败
message
string 
状态说明
必需
processingTime
number 
处理时长
必需
单位:ms
>= 0
data
object 
返回的所有数据
必需
当code为”失败“时,内容为空
offers
array [object {6}] 
报价信息
必需
每一行程可改航班组合
segments
array [object {16}] 
航段信息
必需
包含了所有不重复的航班信息
示例
{
    "traceId": "NEWAPI2501171219143800833",
    "code": "000000",
    "message": "成功",
    "processingTime": 1408,
    "data": {
        "segments": [
            {
                "segmentId": "4b7770e542c79391652570eb468ae138",
                "duration": 180,
                "carrier": "LH",
                "flightNo": "2566",
                "codeShare": false,
                "operatingCarrier": null,
                "operatingFlightNo": null,
                "aircraftCode": "333",
                "depAirport": "SIN",
                "depTerminal": null,
                "depTime": "2025-02-25T04:40",
                "arrAirport": "HKG",
                "arrTerminal": null,
                "arrTime": "2025-02-25T07:40",
                "stopAirport": null,
                "stopDuration": null
            },
            {
                "segmentId": "3d8e50541df087bc066d5150b09d6bb5",
                "duration": 234,
                "carrier": "CA",
                "flightNo": "6719",
                "codeShare": false,
                "operatingCarrier": null,
                "operatingFlightNo": null,
                "aircraftCode": "333",
                "depAirport": "QPG",
                "depTerminal": null,
                "depTime": "2025-02-25T12:10",
                "arrAirport": "HKG",
                "arrTerminal": null,
                "arrTime": "2025-02-25T16:04",
                "stopAirport": null,
                "stopDuration": null
            },
            {
                "segmentId": "7ead00f4aa72410c6cebf71fe7682958",
                "duration": 132,
                "carrier": "9C",
                "flightNo": "6972",
                "codeShare": false,
                "operatingCarrier": null,
                "operatingFlightNo": null,
                "aircraftCode": "333",
                "depAirport": "XSP",
                "depTerminal": null,
                "depTime": "2025-02-25T01:20",
                "arrAirport": "HKG",
                "arrTerminal": null,
                "arrTime": "2025-02-25T03:32",
                "stopAirport": null,
                "stopDuration": null
            },
            {
                "segmentId": "f275d729ad76c2005cfab1f8b7c9de04",
                "duration": 128,
                "carrier": "RS",
                "flightNo": "6972",
                "codeShare": false,
                "operatingCarrier": null,
                "operatingFlightNo": null,
                "aircraftCode": "333",
                "depAirport": "QPG",
                "depTerminal": null,
                "depTime": "2025-02-25T13:55",
                "arrAirport": "HKG",
                "arrTerminal": null,
                "arrTime": "2025-02-25T16:03",
                "stopAirport": null,
                "stopDuration": null
            },
            {
                "segmentId": "5c89b0643a4ebfee9b04b607239d1e99",
                "duration": 142,
                "carrier": "JL",
                "flightNo": "2566",
                "codeShare": false,
                "operatingCarrier": null,
                "operatingFlightNo": null,
                "aircraftCode": "333",
                "depAirport": "SIN",
                "depTerminal": null,
                "depTime": "2025-02-25T18:55",
                "arrAirport": "HKG",
                "arrTerminal": null,
                "arrTime": "2025-02-25T21:17",
                "stopAirport": null,
                "stopDuration": null
            },
            {
                "segmentId": "6510ff5cac7f8f84b6f489ed85d63a62",
                "duration": 294,
                "carrier": "LH",
                "flightNo": "5275",
                "codeShare": false,
                "operatingCarrier": null,
                "operatingFlightNo": null,
                "aircraftCode": "333",
                "depAirport": "QPG",
                "depTerminal": null,
                "depTime": "2025-02-25T12:00",
                "arrAirport": "HKG",
                "arrTerminal": null,
                "arrTime": "2025-02-25T16:54",
                "stopAirport": null,
                "stopDuration": null
            },
            {
                "segmentId": "86b10500a6a85b3a808c16a8ebd3b5ce",
                "duration": 139,
                "carrier": "3U",
                "flightNo": "2566",
                "codeShare": false,
                "operatingCarrier": null,
                "operatingFlightNo": null,
                "aircraftCode": "333",
                "depAirport": "XSP",
                "depTerminal": null,
                "depTime": "2025-02-25T07:55",
                "arrAirport": "HKG",
                "arrTerminal": null,
                "arrTime": "2025-02-25T10:14",
                "stopAirport": null,
                "stopDuration": null
            },
            {
                "segmentId": "0b82607d539ddc35a4ce6114db8025f7",
                "duration": 129,
                "carrier": "OZ"
修改于 2025-06-12 09:38:23
上一页
ancillaryOrderDetail 辅营订单详情
下一页
reissueRequest 改期申请接口
Built with