> For the complete documentation index, see [llms.txt](https://resources.atriptech.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://resources.atriptech.com/api-wen-dang/geng-xin-ri-zhi.md).

# 更新日志

{% hint style="info" %}
遇到 API 接入问题时，可登录 [Eva](https://www.atriptech.com/) 寻求帮助。
{% endhint %}

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

{% updates format="full" %}
{% update date="2026-06-18" %}

## 新增集成辅助 Skill 页面

新增 [集成辅助 Skill](/api-wen-dang/readme/ji-cheng-fu-zhu-skill.md)，用于说明以 `zip` 形式交付的 API 对接辅助资源。

包括这些内容：

* 明确 `Skill` 与 [GitBook MCP 辅助开发](/api-wen-dang/readme/gitbook-mcp-fu-zhu-kai-fa.md) 是并列能力
* 明确适用阶段、常见用途和使用边界
* 在 [集成指南](/api-wen-dang/readme.md) 和 [GitBook MCP 辅助开发](/api-wen-dang/readme/gitbook-mcp-fu-zhu-kai-fa.md) 中补充入口链接
  {% endupdate %}

{% update date="2026-06-16" %}

## 补充废票时效与提交限制说明

在 [废票概览](/api-wen-dang/readme/yu-ding-hou-gai-lan/yu-ding-hou-cao-zuo/fei-piao.md)、[废票 API 参考](/api-wen-dang/api-can-kao/yu-ding-hou-api/fei-piao.md) 和 [预订后](/api-wen-dang/pai-zhang-yu-zhi-chi/faqs/atlas-api-post-ticketing.md) 中补充了废票提交限制与查询预期。

包括这些内容：

* 明确 `voidDeadline` 超时后，提交废票会实时返回错误
* 补充常见错误信息：`Void deadline exceeded. This ticket can no longer be voided`
* 明确 Atlas 只接受整单废票，不支持部分乘客废票
* 明确不支持先拆单或拆 PNR 后再通过 Atlas 提交部分废票
* 明确 `queryVoidOrders.do` 通常可在 `5` 分钟内看到申请是否已成功受理
* 明确最终进展仍需继续轮询，或优先接入 `order.void` webhook
* 明确即使废票服务费固定，也必须先调用 `voidQuotation.do`
  {% endupdate %}

{% update date="2026-06-15" %}

## 强化生产 API 地址说明

在 [生产上线](/api-wen-dang/readme/quick-start/sheng-chan-shang-xian.md)、[快速开始](/api-wen-dang/readme/quick-start.md)、[UAT 验证](/api-wen-dang/readme/quick-start/uat-submission-guide.md)、[搜索](/api-wen-dang/readme/yu-ding-liu-cheng-gai-lan/sou-suo.md)、[搜索 API 参考](/api-wen-dang/api-can-kao/yu-ding-api/sou-suo.md) 和 [Webhook 注册与事件](/api-wen-dang/api-can-kao/webhook-yu-shi-jian-api/webhook-zhu-ce-yu-shi-jian.md) 中强化了环境地址说明。

包括这些内容：

* 明确文档中的完整接口地址默认用于 `sandbox` 示例
* 明确生产地址需要登录 ATRIP，在 **资料管理 → 企业信息** 中查看
* 明确生产环境分为搜索接口地址和业务接口地址
* 明确 `search` 相关请求必须使用独立的生产搜索接口地址
* 明确搜索流量较高，因此生产上为搜索单独部署了接口服务
  {% endupdate %}

{% update date="2026-06-10" %}

## 新增废票 webhook 与废票 API 文档

新增 [废票通知](/api-wen-dang/readme/webhook-gai-lan/fei-piao-tong-zhi.md)，并更新 [废票 API 参考](/api-wen-dang/api-can-kao/yu-ding-hou-api/fei-piao.md) 与相关入口页。

包括这些内容：

* 明确独立事件类型为 `order.void`
* 补充触发时机、payload、字段说明和 `voidStatus` 枚举
* 明确沿用现有 `updateWebhookURL.do` 注册地址即可接收
* 在 [废票概览](/api-wen-dang/readme/yu-ding-hou-gai-lan/yu-ding-hou-cao-zuo/fei-piao.md)、[废票 API 参考](/api-wen-dang/api-can-kao/yu-ding-hou-api/fei-piao.md)、[Webhook 概览](/api-wen-dang/readme/webhook-gai-lan.md)、[Webhook 注册与事件](/api-wen-dang/api-can-kao/webhook-yu-shi-jian-api/webhook-zhu-ce-yu-shi-jian.md)、[预订后 API](/api-wen-dang/api-can-kao/yu-ding-hou-api.md) 和 [预订后概览](/api-wen-dang/readme/yu-ding-hou-gai-lan.md) 中补充入口链接
* 在 [废票 API 参考](/api-wen-dang/api-can-kao/yu-ding-hou-api/fei-piao.md) 中增加 `void.do` 提交后的状态跟踪规则，以及 `order.void` 与 `queryVoidOrders.do` 的配合方式
* 在 [错误码](/api-wen-dang/pai-zhang-yu-zhi-chi/errors-handing.md) 中增加废票 webhook 排查要点
  {% endupdate %}

{% update date="2026-06-09" %}

## 更新 `seatAvailability.do` 调用规则

在 [预订中座位与行李](/api-wen-dang/api-can-kao/yu-ding-api/yu-ding-zhong-zuo-wei-yu-xing-li.md)、[座位](/api-wen-dang/readme/yu-ding-liu-cheng-gai-lan/zuo-wei.md)、[验价](/api-wen-dang/readme/yu-ding-liu-cheng-gai-lan/yan-jia.md)、[获取 Offer](/api-wen-dang/readme/yu-ding-liu-cheng-gai-lan/huo-qu-offer.md) 和 [验价、下单与出票错误](/api-wen-dang/pai-zhang-yu-zhi-chi/errors-handing/yan-jia-xia-dan-yu-chu-piao-cuo-wu.md) 中统一了选座调用规则。

包括这些内容：

* 明确 `Independent Mode` 已下线
* 明确 `seatAvailability.do` 必须基于有效交易上下文调用
* 明确调用时使用 `verify.do` 返回的 `sessionId`，或 `getOffers.do` 返回的 `offerId`
* 明确仅凭航班信息不能直接调用选座接口
* 补充上游只传航班信息时的 `sessionId` 缓存建议
* 补充 `214` 的常见触发原因和处理建议
  {% endupdate %}

{% update date="2026-05-25" %}

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

在 [预订中座位与行李](/api-wen-dang/api-can-kao/yu-ding-api/yu-ding-zhong-zuo-wei-yu-xing-li.md)、[验价、下单与出票错误](/api-wen-dang/pai-zhang-yu-zhi-chi/errors-handing/yan-jia-xia-dan-yu-chu-piao-cuo-wu.md) 和 [错误码](/api-wen-dang/pai-zhang-yu-zhi-chi/errors-handing.md) 中补充了联程行李规则。

包括这些内容：

* 明确 `getLuggage.do` 按航段返回，不代表可按航段独立购买
* 明确同一方向的联程航班必须选择一致的托运行李方案
* 补充 `307` 的一个常见触发场景：同方向联程行李选择不一致
  {% endupdate %}

{% update date="2026-05-20" %}

## 补充 sandbox 基础地址

在 [沙箱访问](/api-wen-dang/readme/quick-start/making-requests.md)、[沙箱环境验证](/api-wen-dang/readme/quick-start/making-requests/sha-xiang-huan-jing-yan-zheng.md) 和 [沙箱开发](/api-wen-dang/readme/quick-start/sha-xiang-kai-fa.md) 中补充了 sandbox 基础地址。

包括这些内容：

* 明确沙箱基础地址是 `https://sandbox.atriptech.com/`
* 说明调用时需在后面拼接具体接口名
* 给出 `search.do` 的完整示例地址
  {% endupdate %}

{% update date="2026-04-15" %}

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

在 [搜索](/api-wen-dang/api-can-kao/yu-ding-api/sou-suo.md)、[沙箱环境验证](/api-wen-dang/readme/quick-start/making-requests/sha-xiang-huan-jing-yan-zheng.md) 和 [搜索与预订](/api-wen-dang/pai-zhang-yu-zhi-chi/faqs/atlas-api-search-and-book.md) 中补充了首次 sandbox 联调的币种要求。

包括这些内容：

* 首次对接时，Atlas 侧可能尚未配置结算币种
* 测试 `search.do` 时，需要手工传 `currency: "USD"`
* 如测试用例要求其他币种，再切换为对应值
  {% endupdate %}

{% update date="2026-04-09" %}

## 新增沙箱环境验证

新增 [沙箱环境验证](/api-wen-dang/readme/quick-start/making-requests/sha-xiang-huan-jing-yan-zheng.md)，用于开发前的无代码 happy path 检查。

包括这些内容：

* 用 Newman 运行 `Search`、`Verify`、`Order` 和 `Pay` 四步验证
* 明确 final retrieve 轮询超时属于预期行为
* 补充凭证、网络、IP allowlist 和 reporter 缺失等高频失败原因
* 在 [快速开始](/api-wen-dang/readme/quick-start.md)、[沙箱访问](/api-wen-dang/readme/quick-start/making-requests.md) 和 [沙箱开发](/api-wen-dang/readme/quick-start/sha-xiang-kai-fa.md) 中补了入口链接
  {% endupdate %}

{% update date="2026-04-08" %}

## 更新错误码首页

基于最新的 Atlas API diagnostics map，重构了 [错误码](/api-wen-dang/pai-zhang-yu-zhi-chi/errors-handing.md) 首页。

包括这些内容：

* 增加按是否可重试的首轮判断
* 增加按流程阶段的错误定位入口
* 增加 `routingIdentifier`、`sessionId` 和出票轮询规则
* 增加无错误码集成模式的排查项
* 明确 `615`、`110`、`415` 等高风险处理方式
  {% endupdate %}

{% update date="2026-04-06" %}

## 新增混合支付指南

新增 [混合支付指南](/api-wen-dang/readme/yu-ding-liu-cheng-gai-lan/zhi-fu-yu-chu-piao/hun-he-zhi-fu-zhi-nan.md)，说明 VCC passthrough 失败后的处理方式。

包括这些内容：

* 什么算混合支付
* 何时切换到 Deposit 或换卡重试
* `pay.do` 失败与航司拒付的区别
* 通过 ATRIP 和 API 的处理流程
* 重建订单、支付重试和 webhook 跟进建议
  {% endupdate %}
  {% endupdates %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://resources.atriptech.com/api-wen-dang/geng-xin-ri-zhi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.