# 错误代码

本页列出了 MoreLogin API 返回的常见错误代码。

## 响应格式

所有 API 响应都遵循以下标准格式：

```json
{
  "code": 0,
  "msg": null,
  "data": {},
  "requestId": "unique-request-id"
}
```

| 字段 | 类型 | 描述 |
|  --- | --- | --- |
| `code` | 整数 | `0` = 成功，`>0` = 错误 |
| `msg` | 字符串 | 错误信息（成功时为空） |
| `data` | 对象 | 响应数据 |
| `requestId` | 字符串 | 用于故障排除的唯一请求标识符 |


## 常见错误代码

### 一般错误

| 代码 | 描述 | 解决方案 |
|  --- | --- | --- |
| `0` | 成功 | — |
| `99001` | 无效参数 | 检查请求正文格式和必填字段 |
| `99002` | 权限被拒绝 | 检查您的帐户权限 |
| `99003` | 请求例外 | 请根据回复进行必要的业务调整 |
| `99004` | 请求正文太大 | 检查您的请求正文 |
| `429` | 超出速率限制 | 降低请求频率并延迟后重试 |


### 浏览器错误（本地 API）

| 代码 | 描述 | 解决方案 |
|  --- | --- | --- |
| `100` | 浏览器已在运行 | 首先使用 `/api/env/close` 关闭浏览器 |
| `101` | 找不到浏览器环境 | 验证 `envId` 或 `uniqueId` |
| `102` | MoreLogin 客户端未运行 | 启动 MoreLogin 桌面应用程序 |
| `103` | 需要加密密钥 | 为加密的浏览器环境提供 `encryptKey` |


### 云手机错误（开放API）

| 代码 | 描述 | 解决方案 |
|  --- | --- | --- |
| `200` | 云手机离线 | 先将云手机开机 |
| `201` | 应用程序安装失败 | 检查 `appVersionId` 或 `packageName` |
| `202` | 文件上传失败 | 验证文件 URL 和目标路径 |


## HTTP 状态代码

| 状态 | 描述 |
|  --- | --- |
| `200` | 请求已处理（检查 `code` 字段以获取业务结果） |
| `401` | 未经授权 - 访问令牌无效或过期 |
| `403` | 禁止 — 权限不足 |
| `429` | 请求过多 — 超出速率限制 |
| `500` | 内部服务器错误 — 联系支持人员 |


> **提示**：联系支持人员时，请始终包含响应中的 `requestId`，以便更快地进行故障排除。