> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Ошибки

> Формат ответа ошибки и коды, возвращенные GOWA API.

Для ошибок используется стандартная структура ответа с кодом, отличным от `SUCCESS`:

```json theme={null}
{
  "code": "VALIDATION_ERROR",
  "message": "phone: cannot be blank."
}
```

Ветка на HTTP статус и код `code`, а не на `message`.

| HTTP | Коды |
| - | - |
| 400 | `VALIDATION_ERROR`, `INVALID_JID`, `ALREADY_LOGGED_IN`, `DEVICE_ID_REQUIRED` |
| 401 | `AUTHENTICATION_ERROR` (не вошедшее в систему устройство); также основные сбои авторизации (нет JSON `code`) |
| 403 | `AVATAR_HIDDEN`, `CROSS_SITE_REQUEST_BLOCKED` |
| 404 | `NOT_FOUND`, `DEVICE_NOT_FOUND`, `AVATAR_NOT_SET` |
| 408 | `CONTEXT_ERROR` |
| 429 | `WA_REACHOUT_TIMELOCK` |
| 500 | `INTERNAL_SERVER_ERROR`, `QR_CHANNEL_ERROR`, `SESSION_SAVED_ERROR`, `UPLOAD_MEDIA_ERROR`, `WEBHOOK_ERROR`, `INVALID_WA_CLI` |
| 503 | `DEVICE_MANAGER_UNAVAILABLE` |
| 504 | `GATEWAY_TIMEOUT` |

Значения, исправления и руководство: [Обработка ошибок](https://gowa-docs.mintlify.site/ru/advanced/error-handling.md).

Для `GET /user/avatar`, `AVATAR_NOT_SET` означает что контакт не имеет изображения профиля. `AVATAR_HIDDEN` означает настройки конфиденциальности запрещает доступ. Сохранять кэшированное изображение при отказе в конфиденциальности, и отличать эти коды от ошибок выбора устройства.


## Related topics

- [Мульти-устройство и выбор устройства](https://gowa-docs.mintlify.site/ru/concepts/multidevice.md)
- [Справочник по API](https://gowa-docs.mintlify.site/ru/api-reference/introduction.md)
- [Интеграция с Chatwoot](https://gowa-docs.mintlify.site/ru/integrations/chatwoot.md)
- [Обработка ошибок](https://gowa-docs.mintlify.site/ru/advanced/error-handling.md)
- [Запланированные отправители](https://gowa-docs.mintlify.site/ru/examples/scheduled-sends.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.