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

voidRequest 废票提交接口

POST
/api/new/voidRequest.do
调用voidRequest接口，来提交废票。FR24通过orderChangeInforming接口推送废票结果。

请求参数

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 时间戳
必需
单位：秒
tktOrderNo
string 
出票订单号
必需
正则匹配:
^\d*$
partnerOrderNo
string 
合作方订单号
可选
passengers
array[object (退票乘客信息) {4}] 
废票乘客信息
必需
paxId
string 
乘客id
必需
name
string 
乘客姓名
必需
姓/名
birthday
string 
乘客生日
可选
格式：YYYY-MM-DD
正则匹配:
^\d{4}-\d{2}-\d{2}$
gender
enum<string> 
乘客性别
可选
枚举值:
FM
示例
{
    "authentication": {
        "sign": "{{sign}}",
        "timestamp": "{{timestamp}}"
    },
    "tktOrderNo": "18599195345358848",
    "partnerOrderNo": "",
    "passengers": [
        {
            "paxId": "1",
            "name": "MCAO/KZZEO",
            "birthday": "1996-09-20",
            "gender": "M"
        }
    ]
}

示例代码

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/voidRequest.do' \
--header 'Accept-Encoding;' \
--header 'appKey;' \
--header 'content-Type: application/json' \
--data-raw '{
    "authentication": {
        "sign": "",
        "timestamp": ""
    },
    "tktOrderNo": "18599195345358848",
    "partnerOrderNo": "",
    "passengers": [
        {
            "paxId": "1",
            "name": "MCAO/KZZEO",
            "birthday": "1996-09-20",
            "gender": "M"
        }
    ]
}'

返回响应

🟢200OK
application/json
Body
traceId
string 
追溯码
必需
code
string 
状态码
必需
000000 代表成功，其他代表失败
message
string 
状态说明
必需
processingTime
number 
处理时长
必需
单位：ms
>= 0
data
object 
返回的所有数据
可选
当code为”失败“时，内容为空
voidOrderNo
string 
废票订单号
必需
tktOrderNo
string 
出票订单号
可选
voidOrderStatus
string 
废票订单状态
必需
示例
{
    "traceId": "NEWAPI2501171227465020840",
    "code": "000000",
    "message": "成功",
    "processingTime": 1568,
    "data": {
        "voidOrderNo": "18599208552566784",
        "voidOrderStatus": "36",
        "tktOrderNo": "18599195345358848"
    }
}
修改于 2025-06-12 09:38:47
上一页
refundConfirming 退票确认接口
下一页
fileUpload 文件上传
Built with