FR24 OpenAPI
  1. 指南
FR24 OpenAPI
  • FR24_API_V2.0
    • 指南
      • API调用流程
      • 介绍
      • 附录
      • 错误码
    • API 参考
      • OrderChangeInforming 订单信息变更通知
      • Shopping 航班搜索接口
      • Pricing 校验接口
      • Booking 生单接口
      • Ticketing 申请出票接口
      • OrderDetail 订单详情接口
      • PresaleAncillaryShopping 售前辅营搜索接口
      • PostsaleAncillaryShopping 售后行李搜索接口
      • seatMap 机型图接口
      • AncillaryBooking 辅营生单接口
      • AncillaryPurchase 辅营支付接口
      • AncillaryOrderDetail 辅营订单详情
      • ChangeReshop 改期搜索接口
      • ReissueRequest 改期申请接口
      • RefundRequest 退票申请接口
      • RefundConfirming 退票确认接口
      • VoidRequest 废票提交接口
      • FileUpload 文件上传
      • SelectBalance 余额查询接口
    • 关于我们
      • API 能力
      • 商务合作
      • 门户网站
  1. 指南

介绍

接口信息#

接口名称功能
shopping查询可用航班信息。支持单程、往返程、缺口程线路查询
pricing获取航班实时价格和座位
booking预定航班座位,支持同时预定辅营
ticketing订单支付和申请出票。当用户调用 ticketing 接口的时候FR24会对用户费用进行冻结,但是直到在出票完成之后,才对用户进行真实扣费
orderDetail查看机票订单详情,查看订单状态、票号
orderChangeInforming通知订单信息变更,包含票号或航司大编码推送、订单状态变更通知、航班变化通知、辅营订单状态通知、售后信息推送
presaleAncillaryShopping搜索售前可添加的辅营产品
postsaleAncillaryShopping搜索订单可添加的售后辅营产品
ancillaryBooking预定添加的辅营产品
ancillaryPurchase售后辅营订单支付
ancillaryOrderDetail查看售后辅营订单详情
changeReshop搜索改期航班信息
reissueRequest提交改期核价
refundRequest提交退票核价
refundConfirm确认退票,若无需核价,也可直接调用该接口申请退票
voidRequest提交废票申请

接口协议#

说明:旧版API 于2023年3月31日停止更新,新版接口和旧版接口会并行使用至2024年3月31日,届时旧版v0.5x版本接口将会终止提供服务。

接口规则#

提供接口 https访问 URL, 统一字符编码: UTF-8
接口请求 content-Type="application/json"
接口通过 post 请求接口 url 并发送符合 JSON 规范的 body

接入流程#

1. 创建应用账号#

联系 FR24 工作人员创建应用账号 appkey 和对应密钥 appSecret,并分配接口访问权限。

2. header#

为了节省带宽加快传输速率,在请求头中设置⽀持 gzip 压缩格式 Accept-Encoding:gzip,未支持 gzip 压缩的请求和响应将会被拦截。
名称说明
appkey用户账户
Accept-Encoding使用 gzip 压缩格式
content-Typeapplication/json

3. 用户认证#

接口使用 appkey 身份识别和 ip 白名单验证机制,需要合作方提供详细 ip 名单以供 FR24 作身份验证。
若合作方需要 FR24 的 ip 列表,请联系商务获取。

4. 生产环境链接#

生产环境链接将会在测试无误后,由对接人员提供。
修改于 2025-04-27 03:29:38
上一页
API调用流程
下一页
附录
Built with