开放能力可能返回两类错误码：
- JSSDK 错误码：前端 JS SDK 调用宿主能力时返回的业务结果。
- API 错误码：后端 API 调用时返回的 HTTP 状态码、
code和msg。
:::note
code 为 0 表示调用成功；非 0 表示本次调用失败。后端 API 还需要同时看 HTTP 状态码。
:::
JSSDK 错误码
JSSDK 方法通常返回 code、msg 和 data。如果 code 不是 0，按下表处理。
| code | 含义 | 处理建议 |
|---|---|---|
0 | 调用成功 | 不需要处理 |
1000000 | 服务或内部异常 | 服务状态异常，建议刷新状态后再试 |
1000001 | 登录或认证失败 | 重新登录或重新完成认证 |
1000002 | 管理员权限或 API Scope 不足 | 检查 API Scope 是否正确声明 |
1000030 | 请求不合法，或当前路径不支持该操作 | 检查请求参数、路径类型和当前能力状态 |
1000300 | 未找到已安装应用 | 确认应用已安装且运行中 |
1000701 | 路径不存在 | 提示用户重新选择一个存在的路径 |
1003103 | 应用权限校验失败 | 尝试重新安装应用 |
1003201 | 管理员已关闭该应用的普通用户授权能力 | 提示仅管理员可进行此操作 |
WARNING
普通用户调用应用共享授权入口时，宿主内直调可能返回 code: 1 和 msg: "仅管理员可进行此操作"；授权跳转回调可能返回 status: "error" 和 error: "access_denied"。这两种情况都表示当前用户没有权限执行该授权操作。
API 错误码
后端 API 调用失败时，优先检查 HTTP 状态码、响应体中的 code 和 msg。
| HTTP 状态码 | code | msg | 常见原因和处理建议 |
|---|---|---|---|
200 或 400 | 200001 | Invalid Params | 业务参数不合法，检查 JSON 格式、字段类型是否符合接口要求 |
401 | 200004 | Unauthorized | 检查应用后端是否拿到了有效 token |
403 | 200003 | Forbidden | 检查应用包是否声明了对应 API Scope，并确认 token 已包含该 Scope |
404 | 200005 | Not Found | 检查 req 是否写错、接口是否已注册，或当前系统版本是否提供该能力 |
200 或 500 | 200006 | Internal Error | 具体业务模块内部错误 |
本页要点
code为0表示成功，非0表示失败。- 前端 JS SDK 失败先看 JSSDK 错误码；后端 API 失败先看 HTTP 状态码、
code和msg。 - 普通用户调用应用共享授权入口时，可能返回
code: 1或access_denied。 Forbidden优先检查 API Scope 和 token；Not Found优先检查req和系统版本。