# 集成指南

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

从这里开始完成 Atlas API 集成。

### 推荐阅读顺序

1. [快速开始](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/quick-start)
2. [沙箱访问](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/quick-start/making-requests)
3. [沙箱开发](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/quick-start/sha-xiang-kai-fa)
4. [预订流程概览](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/yu-ding-liu-cheng-gai-lan)
5. [Webhook 概览](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/webhook-gai-lan)
6. [UAT 验证](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/quick-start/uat-submission-guide)
7. [生产上线](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/quick-start/sheng-chan-shang-xian)

### 选择合适路径

#### 新接入

先看 [快速开始](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/quick-start)。

然后按顺序推进：

* [沙箱访问](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/quick-start/making-requests)
* [沙箱开发](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/quick-start/sha-xiang-kai-fa)
* [UAT 验证](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/quick-start/uat-submission-guide)
* [生产上线](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/quick-start/sheng-chan-shang-xian)

#### 核心预订流程

搜索、验价、下单、支付和订单查询，请看 [预订流程概览](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/yu-ding-liu-cheng-gai-lan)。

#### 预订后操作

退款、维护、增值服务和 PNR 相关操作，请看 [预订后概览](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/yu-ding-hou-gai-lan) 和 [预订后操作](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/yu-ding-hou-gai-lan/yu-ding-hou-cao-zuo)。

#### 特殊业务流程

只有在业务需要航司专属逻辑或折扣票价逻辑时，才使用 [特殊集成](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/te-shu-ji-cheng)。

#### 运维工具

余额、邮件、导出和 ATRIP 访问，请看 [工具 API 概览](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/gong-ju-api-gai-lan)。

#### 测试和参考数据

共享枚举、沙箱测试航线和测试卡，请看 [集成参考](https://resources.atriptech.com/api-wen-dang/ji-cheng-can-kao)。

### 典型集成流程

{% stepper %}
{% step %}

### 沙箱访问

获取沙箱凭证，并确认请求头配置。
{% endstep %}

{% step %}

### 沙箱开发

在沙箱中完成预订链路，并验证 webhook 处理。
{% endstep %}

{% step %}

### UAT 验证

提交对应 UAT 轨道及证据。
{% endstep %}

{% step %}

### 生产上线

UAT 通过且账号切换为 `LIVE` 后，生成生产凭证并切换到生产接口地址。
{% endstep %}
{% endstepper %}

### 什么时候看 API Reference

当你需要精确的 schema、参数和接口级示例时，使用 [API Reference](https://resources.atriptech.com/api-wen-dang/api-can-kao)。

### 按能力浏览接口分组

* [预订 API](https://resources.atriptech.com/api-wen-dang/api-can-kao/yu-ding-api)
* [预订后 API](https://resources.atriptech.com/api-wen-dang/api-can-kao/yu-ding-hou-api)
* [Webhook 与事件 API](https://resources.atriptech.com/api-wen-dang/api-can-kao/webhook-yu-shi-jian-api)
* [工具 API](https://resources.atriptech.com/api-wen-dang/api-can-kao/gong-ju-api)

### 需要排障支持

常见问题、错误码和升级路径，请看 [排障与支持](https://resources.atriptech.com/api-wen-dang/pai-zhang-yu-zhi-chi)。