# 通用与访问错误

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

当请求在业务处理开始前就失败时，使用这页。

### 本页覆盖内容

* 字段缺失
* 请求格式无效
* 凭证和访问失败
* 通用系统错误

### 常见错误码

#### `100` Missing required request data

缺少必填字段。

**处理建议**

* 检查必填参数
* 重建请求体
* 校验后再重试

#### `900` Unauthorized access

凭证错误、账号状态无效，或请求访问了超出权限范围的数据。

**处理建议**

* 检查 `x-atlas-client-id`
* 检查 `x-atlas-client-secret`
* 确认账号处于激活状态

#### `901` Illegal request data

请求格式无效。

**处理建议**

* 发送 JSON
* 检查字段类型和嵌套结构
* 重试前先校验必需结构

#### `902` Access denied

请求因权限或账号范围限制被拦截。

**处理建议**

* 重新检查凭证
* 确认账号有权限访问该能力
* 如果按理应可访问，请联系 Atlas

#### `9999` System error

平台侧的非预期失败。

**处理建议**

* 先重试一次
* 若仍复现，记录 request ID 后升级支持

#### `-1` Common error

未返回更具体错误码时使用的兜底错误。

**处理建议**

* 检查请求上下文
* 若为瞬时问题可重试
* 若反复出现则升级支持

### 推荐排查顺序

1. 确认凭证和账号状态
2. 校验 JSON 格式和必填字段
3. 对瞬时失败重试一次
4. 若错误重复，带上请求上下文升级支持

### 相关页面

* [沙箱访问](https://resources.atriptech.com/api-wen-dang/ji-cheng-zhi-nan/quick-start/making-requests)
* [排障与支持](https://resources.atriptech.com/api-wen-dang/pai-zhang-yu-zhi-chi)