# 快速开始

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

用这页把 Atlas 集成从沙箱推进到正式上线。

<figure><img src="https://content.gitbook.com/content/ClIWQjtgO3wtMk0oYDks/blobs/0MytgvvNAYvGfDnc0tHb/FlowChart_1_QuickStart.png" alt=""><figcaption><p>从沙箱访问到生产上线的完整集成流程</p></figcaption></figure>

### 集成流程

{% stepper %}
{% step %}

### 沙箱访问

生成沙箱凭证，并确认基础请求要求。
{% endstep %}

{% step %}

### 沙箱开发

在沙箱中完成完整集成并验证结果。
{% endstep %}

{% step %}

### UAT 验证

在沙箱链路稳定后，完成对应的 UAT 轨道。
{% endstep %}

{% step %}

### 生产上线

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

### 完整流程怎么走

#### 1. 沙箱访问

这是集成起点。

在 ATRIP 中生成沙箱 client ID 和 client secret。

继续前先确认：

* 标准请求头
* 请求格式
* 标识符处理
* gzip 处理

当你能稳定发送沙箱请求时，就可以进入下一阶段。

开始开发前，建议先运行 [沙箱环境验证](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/quick-start/sha-xiang-huan-jing-yan-zheng)。

它可无代码确认凭证、网络和 happy path 已就绪。

请先看 [沙箱访问](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/quick-start/making-requests)。

#### 2. 沙箱开发

这一阶段完成实际开发工作。

通常包括：

* 沙箱环境配置
* 搜索、验价、下单和支付
* 订单查询与出票跟进
* webhook 注册与事件处理
* 沙箱测试数据与失败模拟

目标不只是接口能调通。

目标是在沙箱中跑通完整业务链路。

开发时建议配合这些页面：

* [沙箱开发](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/quick-start/sha-xiang-kai-fa)
* [预订流程概览](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/yu-ding-liu-cheng-gai-lan)
* [Webhook 概览](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/webhook-gai-lan)

这一阶段要保存这些标识符：

* 搜索：`routingIdentifier`
* 验价：`sessionId`
* 订单：`orderNo`

只有沙箱链路稳定且可重复后，再进入 UAT。

#### 3. UAT 验证

UAT 是生产前验证阶段。

它用于证明你的集成已经具备上线条件。

需要准备：

* 正确的 UAT 模板
* 端到端证据
* 必要时的 webhook 样例
* 相关订单号或请求 ID

这一阶段的核心产出是 UAT 通过。

提交步骤见 [UAT 验证](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/quick-start/uat-submission-guide)。

#### 4. 生产上线

当沙箱工作完成，且你准备进入生产时，再开始这一阶段。

然后依次完成：

* 完成所需 UAT
* 等待客户经理把账号切到 `LIVE`
* 生成生产凭证
* 替换沙箱接口地址
* 运行受控 smoke test
* 监控首批生产订单和 webhook
* 正式上线

这一步完成从测试集成到正式运行的切换。

上线清单见 [生产上线](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/quick-start/sheng-chan-shang-xian)。

### 各阶段产出

* 沙箱访问 → 沙箱 client ID 和 client secret
* 沙箱开发 → 稳定的沙箱预订与 webhook 链路
* UAT 验证 → 已通过的验证结果
* 生产上线 → 可用的生产环境

### 首个端到端测试资源

沙箱开发时可先用这份 Postman 集合：

{% file src="<https://content.gitbook.com/content/ClIWQjtgO3wtMk0oYDks/blobs/XCOq8hSKOafCwmRsNdo6/TheAtlas%20UAT%20Test%20Shopping%20&%20Ticketing%20Services%20Only%20Postman%20Collection.zip>" %}