# Коды ошибок

На этой странице перечислены распространенные коды ошибок, возвращаемые API MoreLogin.

## Формат ответа

Все ответы 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. |
| `103` | Требуется ключ шифрования | Укажите `encryptKey` для зашифрованных профилей. |


### Ошибки облачного телефона (открытый API)

| Код | Описание | Решение |
|  --- | --- | --- |
| `200` | Облачный телефон не в сети | Сначала включите облачный телефон |
| `201` | Установка приложения не удалась | Проверьте `appVersionId` или `packageName`. |
| `202` | Загрузка файла не удалась | Проверьте URL-адрес файла и путь назначения |


## Коды состояния HTTP

| Статус | Описание |
|  --- | --- |
| `200` | Запрос обработан (проверьте поле `code` для получения бизнес-результата) |
| `401` | Неавторизованный — недействительный или просроченный токен доступа. |
| `403` | Запрещено — недостаточно разрешений |
| `429` | Слишком много запросов — превышен лимит скорости |
| `500` | Внутренняя ошибка сервера — обратитесь в службу поддержки. |


> **Совет**. Всегда указывайте `requestId` из ответа при обращении в службу поддержки, чтобы ускорить устранение неполадок.