# 快速开始

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

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

<figure><img src="/files/aTjtnzkFysZuEZHdt5uy" 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 处理

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

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

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

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

#### 2. 沙箱开发

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

通常包括：

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

目标不只是接口能调通。

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

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

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

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

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

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

#### 3. UAT 验证

UAT 是生产前验证阶段。

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

需要准备：

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

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

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

#### 4. 生产上线

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

然后依次完成：

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

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

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

### 各阶段产出

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

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

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

{% file src="/files/WhWRaZn7IthcEmLJkM2V" %}


---

# Agent Instructions: 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/ji-cheng-zhi-nan/quick-start.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.