更新日志

跟踪文档新增和重要更新。

遇到 API 接入问题时,可登录 Eva 寻求帮助。

用这页跟踪最近的文档新增和重要更新。

新增废票 webhook 与废票 API 文档

新增 废票通知,并更新 废票 API 参考 与相关入口页。

包括这些内容:

更新 seatAvailability.do 调用规则

预订中座位与行李座位验价获取 Offer验价、下单与出票错误 中统一了选座调用规则。

包括这些内容:

  • 明确 Independent Mode 已下线

  • 明确 seatAvailability.do 必须基于有效交易上下文调用

  • 明确调用时使用 verify.do 返回的 sessionId,或 getOffers.do 返回的 offerId

  • 明确仅凭航班信息不能直接调用选座接口

  • 补充上游只传航班信息时的 sessionId 缓存建议

  • 补充 214 的常见触发原因和处理建议

明确联程行李的下单校验规则

预订中座位与行李验价、下单与出票错误错误码 中补充了联程行李规则。

包括这些内容:

  • 明确 getLuggage.do 按航段返回,不代表可按航段独立购买

  • 明确同一方向的联程航班必须选择一致的托运行李方案

  • 补充 307 的一个常见触发场景:同方向联程行李选择不一致

补充 sandbox 基础地址

沙箱访问沙箱环境验证沙箱开发 中补充了 sandbox 基础地址。

包括这些内容:

  • 明确沙箱基础地址是 https://sandbox.atriptech.com/

  • 说明调用时需在后面拼接具体接口名

  • 给出 search.do 的完整示例地址

补充首次 sandbox 搜索的币种说明

搜索沙箱环境验证搜索与预订 中补充了首次 sandbox 联调的币种要求。

包括这些内容:

  • 首次对接时,Atlas 侧可能尚未配置结算币种

  • 测试 search.do 时,需要手工传 currency: "USD"

  • 如测试用例要求其他币种,再切换为对应值

新增沙箱环境验证

新增 沙箱环境验证,用于开发前的无代码 happy path 检查。

包括这些内容:

  • 用 Newman 运行 SearchVerifyOrderPay 四步验证

  • 明确 final retrieve 轮询超时属于预期行为

  • 补充凭证、网络、IP allowlist 和 reporter 缺失等高频失败原因

  • 快速开始沙箱访问沙箱开发 中补了入口链接

更新错误码首页

基于最新的 Atlas API diagnostics map,重构了 错误码 首页。

包括这些内容:

  • 增加按是否可重试的首轮判断

  • 增加按流程阶段的错误定位入口

  • 增加 routingIdentifiersessionId 和出票轮询规则

  • 增加无错误码集成模式的排查项

  • 明确 615110415 等高风险处理方式

新增混合支付指南

新增 混合支付指南,说明 VCC passthrough 失败后的处理方式。

包括这些内容:

  • 什么算混合支付

  • 何时切换到 Deposit 或换卡重试

  • pay.do 失败与航司拒付的区别

  • 通过 ATRIP 和 API 的处理流程

  • 重建订单、支付重试和 webhook 跟进建议

Last updated

Was this helpful?