FR24 OpenAPI

ReissueRequest 改期申请接口

POST

/api/new/reissueRequest.do

调用reissueRequest提交改期申请，FR24会在核价完成后，使用orderChangeInforming接口将结果通知，调用票务API确认补发。

请求参数

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

必需

单位：秒

tktOrderNo

string

FR24出票订单号

必需

<= 17 字符

正则匹配:

^\d*$

originalSegments

array[object (原始航段信息) {3}]

待改期的原始航班信息

必需

carrier

string

航司二字码

必需

flightNo

string

航班号

必需

depTime

string <date-time>

出发时间

必需

格式：YYYY-MM-DDTHH:mm

newLegs

array [object {7}]

新改期航班

必需

carrier

string

航司

必需

flightNo

string

航班号

必需

depAirport

string

起飞机场

必需

depTime

string

起飞时间

必需

格式：YYYY-MM-DDTHH:mm

正则匹配:

\d{4}-\d{2}-\d{2}T\d{2}:\d{2}

arrAirport

string

到达机场

必需

arrTime

string

到达时间

必需

格式：YYYY-MM-DDTHH:mm

正则匹配:

\d{4}-\d{2}-\d{2}T\d{2}:\d{2}

RBD

string

舱位

可选

若无则改原舱位，FR24在核价完成后会返回最低可改舱位

offerId

string

changeReshopRS返回的报价唯一标识

必需

offerId和newLegs其中一个必填。若传offerId，newLegs为非必填；若传newLegs，offerId为非必填。

passengers

array[object (退票乘客信息) {4}]

乘客信息

必需

paxId

string

乘客id

必需

name

string

乘客姓名

必需

姓/名

birthday

string

乘客生日

可选

格式：YYYY-MM-DD

正则匹配:

^\d{4}-\d{2}-\d{2}$

gender

enum<string>

乘客性别

可选

枚举值:

cabin

string

舱等

可选

若不传则默认原舱等改期

changeReason

enum<string>

改期理由

必需

枚举值:

0123

正则匹配:

0|1|2|3

remarks

string

备注

可选

fileData

array [object {1}]

非自愿改期证明文件

必需

取自file upload接口

fileId

string

文件id

必需

示例

{
  "authentication": {
    "sign": "{{sign}}",
    "timestamp": "{{timestamp}}"
  },
  "tktOrderNo": "18599172460974080",
  "originalSegments": [
    {
      "carrier": "TW",
      "flightNo": "9975",
      "depTime": "2025-11-15T16:50"
    }
  ],
  "newLegs": [
    {
      "carrier": "TW",
      "flightNo": "9975",
      "depAirport": "SIN",
      "depTime": "2025-11-15T16:50",
      "arrAirport": "HKG",
      "arrTime": "2025-11-15T19:33",
      "RBD": ""
    }
  ],
  "passengers": [
    {
      "paxId": "1",
      "name": "FKV/XBGAE",
      "birthday": "1967-07-26",
      "gender": "M"
    }
  ],
  "cabin": "",
  "changeReason": "3",
  "remarks": "测试",
  "fileData": []
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://flight-test.flightroutes24.com/api/new/reissueRequest.do' \
--header 'Accept-Encoding;' \
--header 'appKey;' \
--header 'content-Type: application/json' \
--data-raw '{
    "authentication": {
        "sign": "",
        "timestamp": ""
    },
    "tktOrderNo": "18599172460974080",
    "originalSegments": [
        {
            "carrier": "TW",
            "flightNo": "9975",
            "depTime": "2025-11-15T16:50"
        }
    ],
    "newLegs": [
        {
            "carrier": "TW",
            "flightNo": "9975",
            "depAirport": "SIN",
            "depTime": "2025-11-15T16:50",
            "arrAirport": "HKG",
            "arrTime": "2025-11-15T19:33",
            "RBD": ""
        }
    ],
    "passengers": [
        {
            "paxId": "1",
            "name": "FKV/XBGAE",
            "birthday": "1967-07-26",
            "gender": "M"
        }
    ],
    "cabin": "",
    "changeReason": "3",
    "remarks": "测试",
    "fileData": []
}'

返回响应

🟢200OK

application/json

Body

traceId

string

追溯码

必需

code

string

状态码

必需

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

message

string

状态说明

必需

processingTime

number

处理时长

必需

单位：ms

>= 0

data

object

返回的所有数据

可选

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

changeOrderNo

string

改期单号

必需

tktOrderNo

string

原始订单号

必需

changeOrderStatus

string

改期订单状态

必需

示例

{
  "traceId": "NEWAPI2501171222227570837",
  "code": "000000",
  "message": "成功",
  "processingTime": 1297,
  "data": {
    "changeOrderNo": "18599187318378496",
    "tktOrderNo": "18599172460974080",
    "changeOrderStatus": "改期待审核"
  }
}

修改于 2025-01-20 02:45:57

ChangeReshop 改期搜索接口

RefundRequest 退票申请接口