OneWorldTrip
English中文
English中文
  1. 中文
  • 接入说明
  • 机票分销 内容聚合直连API
    • 查询接口（Search）
      POST
    • 验价接口（Verify)
      POST
    • 预定接口（Order）
      POST
    • 取消接口（Cancel）
      POST
    • 支付校验接口（PayValidate）
      POST
    • 订单状态推送接口（Order Status Push）
      POST
    • 获取订单详情接口(Get OrderInfo)
      POST
    • 预定接口（Order）即将废弃
      POST
  • 分销订单管理API
    • 订单管理流程
    • 密码加密方式
    • 票号回填接口（Ticket Issuance）
      POST
    • 获取待出票订单接口（openIssueOrderList）
      POST
    • 出票单详情接口（openIssueOrderInfo）
      POST
    • 获取售后订单接口（afterSale/orderList）
      POST
    • 催出票接口
      POST
  • 航变API
    • 航变流程
    • 航变通知接口（flightChangeNotify）
      POST
  • 缓存刷新API
    • 消息通知接口（RefreshNotify）
      POST
    • 缓存刷新接口（CacheRefresh）
      POST
  • 辅营订单管理API
    • 辅营订单流程
    • 辅营产品查询接口（AuxSearch）
      POST
    • 供应机型图报价接口（SeatMap）
      POST
    • 查询辅营订单列表接口（QueryAncillaryOrderList）
      POST
    • 更新辅营状态接口（UpdateAncillaryStatus）
      POST
    • 查询辅营订单详情接口（QueryAncillaryOrderDetail）
      POST
English中文
English中文
  1. 中文

接入说明

接口调用流程#

简易中文版.jpg#

注意事项#

INFO
1.
数据返回规范
仅返回请求中指定乘客类型的数据（如只请求成人票，不返回儿童/婴儿票价）
Search接口收到无内容投放请求时，会按空数据格式返回：
{
  "status": 0,
  "msg": "success",
  "shopsign": [],
  "flight": []
}
2.
价格变动规则
允许变价，但需监控变价率
预订依赖验价接口返回的航班和价格信息

接口分类#

必接接口列表#

1.
搜索（Search）
2.
验价（Verify）
3.
预定（Order）
4.
获取出票订单（OpenIssuesOrderList）
5.
出票回填（Ticket Issuance）
6.
供应接收确认航变API（GetPendingScheduleChange）
7.
供应答复确认航变接口 （ReplyPendingScheduleChange）
8.
取消接口或订单状态推送接口（二选一）

可选接口列表#

1.
航变通知接>口（flightChangeNotify）
2.
出票单详情接口（openIssueOrderInfo）
3.
获取售后订单接口（afterSale/orderListV2）
4.
选座接口（SeatMap）
5.
查询辅营订单列表接口（QueryAncillaryOrderList）
6.
更新辅营状态接口（UpdateAncillaryStatus）
7.
查询辅营订单详情接口（QueryAncillaryOrderDetail）
8.
消息通知接口（ErrorNotification）
9.
缓存刷新接口（CacheRefresh）

API 功能说明#

功能概述#

分享商直连 API 要接入以下核心功能：
搜索（Search）
价格验核（Verify）
订单生成（Order）
座位选择（SeatMap）
订单取消（Cancel）
订单状态推送（Order Status Push）

文档读者本文档面向：#

⚠️ 具有技术开发能力的工程师

技术支持#

支持类型联系方式
技术咨询it.flight@oneworldtrip.cn
商务对接联系您的专属商务经理

开发规范#

接口统一标准#

1.
字符编码
统一使用 UTF-8 编码
2.
数据传输格式
3.
请求方式
仅支持 HTTP POST 方法
请求体需符合 JSON 规范
4.
身份验证
使用 vendorCode 标识供应商身份
启用 IP 白名单验证机制

数据返回规则#

1.乘客类型一致性返回的乘客类型必须与请求参数严格匹配禁止返回冗余的乘客类型数据
2.错误码规范严格遵循文档定义的错误码类型和格式
Modified at 2025-10-11 01:52:41
Next
查询接口（Search）
Built with