# Коди помилок

На цій сторінці наведено типові коди помилок, які повертає 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` для зашифрованих профілів |


### Помилки Cloud Phone (відкритий API)

| Код | опис | Рішення |
|  --- | --- | --- |
| `200` | Хмарний телефон офлайн | Спочатку увімкніть хмарний телефон |
| `201` | Помилка встановлення програми | Перевірте `appVersionId` або `packageName` |
| `202` | Помилка завантаження файлу | Перевірте URL-адресу файлу та шлях призначення |


## Коди стану HTTP

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


> **Порада**: завжди вказуйте `requestId` із відповіді, коли звертаєтеся до служби підтримки, щоб швидше вирішити проблему.