OTA 平台接口
统一入口
/direct/platform/{platform}{platform} 取值：
| 值 | 平台 |
|---|---|
qunar | 去哪儿 |
feizhu | 飞猪 |
ctrip | 携程 |
tongcheng | 同程 |
经过网关访问时，通常要加上 /prod-api 前缀。
接口列表
| 业务 | 标准入口 | 兼容入口 | 说明 |
|---|---|---|---|
| 搜索 | POST /search | POST /ShoppingOffer | 查询符合库存、投放和规则的报价 |
| 验价 | POST /verify | POST /ConfirmOffer | 按运价编码重新确认报价 |
| 下单 | POST /order | POST /CreateOrder | 验价后创建订单，报文可按平台加密 |
| 支付 | POST /pay | — | 校验订单与 PNR 后执行支付策略 |
下单和支付接口按平台约定的报文收发（text/plain），支持按平台配置报文加解密。各 OTA 的字段结构、校验要求、加密方式和响应格式由对应的平台适配器负责；实际上线时，以合作平台提供的最新协议和联调结果为准。
内部标准查询
平台适配器把 OTA 请求转换为内部标准查询。标准搜索请求的主要字段：
| 字段 | 说明 |
|---|---|
platform | 平台：QUNAR / FEIZHU / CTRIP / TONGCHENG |
channelId | 渠道标识 |
tripType | 行程类型 |
depCity / arrCity | 出发 / 到达城市三字码 |
depDate / retDate | 出发 / 返程日期 |
adultCount / childCount / infantCount | 各类旅客人数 |
requestedSegments | 指定航段（可选） |
内部调试入口 POST /direct/query/search 和 POST /direct/query/verify 直接接收标准请求并返回标准报价（DirectRouting），便于在没有平台报文时验证规则。验价没有可匹配报价时返回 NO_MATCHED_ROUTING。
搜索
搜索按规则执行顺序计算报价，返回每条报价的售价、税费、最大展示座位数、退改签和行李信息，以及运价编码。
验价
验价以运价编码为核心，重新加载并校验库存、投放和规则，确认报价在下单前仍然有效。如果来源策略配置了外部供应商验价，还会调用对应的供应商适配器并记录调用日志。
下单与支付
- 下单前再次验价；
- 价格变动超过来源策略的阈值时直接拒单；
- 校验通过后先生成本地订单，并立即响应 OTA；
- 供应商下单在后台异步执行，完成后回填供应商订单号、PNR、价格和购买链接；
- 失败时保留失败状态和原因，供运营处理；
- 支付接口校验订单与 PNR 后，按来源策略执行支付。
详见下单与供应商路由。
链路追踪
每次平台调用都会生成链路追踪号 traceId，记录接口类型、请求、响应、耗时和结果。traceId 贯穿平台日志和供应商日志，可用于端到端排查。