沙箱访问

在开发前获取沙箱访问权限，并确认基础请求要求。

用这页完成沙箱访问准备，并发送第一批 API 请求。

本阶段目标

完成沙箱的初始接入配置。

在开始构建预订流程前，应先完成这一步。

生成沙箱凭证

在 ATRIP 中获取沙箱凭证：

1. 打开 Profile

2. 打开 My Profile

3. 打开 Company Information

在 Sandbox Info 中可以看到：

• x-atlas-client-id

• x-atlas-client-secret

每次调用沙箱 API 都要带上这两个值。

标准请求头

默认发送以下请求头：

• Content-Type: application/json

• Accept: application/json

• Accept-Encoding: gzip

• x-atlas-client-id: <your-client-id>

• x-atlas-client-secret: <your-client-secret>

基础请求规则

默认请求形式如下：

POST /<endpoint>.do

• Atlas API 一律使用 POST

• 每个请求都发送 JSON body

后续会用到的标识符

后续步骤会拿到这些标识符。

它们会在预订链路中反复使用：

• routingIdentifier

• sessionId

• orderNo

响应与压缩处理

Atlas 的响应可能很大。

如果发送 Accept-Encoding: gzip，就必须正确处理 gzip 响应。

大多数 HTTP 客户端会自动解压。

所有集成都应遵循这些规则：

• status == 0 视为成功

• 不要用 msg 驱动业务逻辑

• 进入下一步前先检查返回的标识符

• 返回 Content-Encoding: gzip 时要正确处理压缩响应

安全要求

两个凭证都要保存在服务端。

不要暴露给客户端应用。

联调和测试使用沙箱。

验证完成后再切到生产环境。

完成标准

当你能在沙箱中做到以下几点时，这一阶段就完成了：

• 成功发送带认证的请求

• 正确使用标准请求头

• 明确哪些标识符会在后续复用

• 正确处理 gzip 响应

本阶段产出

• 沙箱 client ID 和 client secret

• 可用的请求配置

• 可开始开发的沙箱环境

下一步

继续阅读 沙箱开发。

相关页面

• 快速开始

• 沙箱开发

• 预订流程概览