通用与访问错误

认证、请求格式和账号访问相关的高频共享错误。

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

本页覆盖内容

• 字段缺失

• 请求格式无效

• 凭证和访问失败

• 通用系统错误

常见错误码

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. 若错误重复，带上请求上下文升级支持

相关页面

• 沙箱访问

• 排障与支持