> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.erlcrussia.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Коди Помилок
> Якщо API ER:LC Росія відхиляє запит, він повертає JSON-відповідь із кодом помилки. На цій сторінці можна легко зрозуміти, що саме пішло не так і як вашому сервісу це виправити.
### Формат Відповіді Про Помилку
Усі помилки повертаються у форматі JSON із полями `code` та `message`.
**Наприклад:**
```json theme={null}
{
"code": 5007,
"message": "Missing Token"
}
```
## Таблиця Помилок API ER:LC Росія
| Код | Опис | Значення |
| ------ | ---------------------------- | --------------------------------------------------------------------------- |
| `5001` | Missing Discord Id | Відсутній `discord_id`. Додайте поле `discord_id` у тіло запиту |
| `5002` | Missing Parameters | Відсутні обов'язкові параметри. Перевірте тіло запиту |
| `5003` | Invalid Version | Невірна версія API. Використовуйте `v1` або `v2` |
| `5004` | Invalid Param Name | Невірне ім'я query-параметра |
| `5005` | Missing Command | Не передано команду. Додайте поле `command` у тіло запиту |
| `5006` | Invalid Master Key | Недійсний майстер-ключ. Зверніться до адміністратора |
| `5007` | Missing Token | Відсутній токен. Додайте заголовок `Authorization: Bearer <токен>` |
| `5008` | Invalid Token | Токен недійсний або деактивований |
| `5009` | Forbidden | Немає доступу до цього ендпоінта. Зверніться до адміністратора |
| `5010` | Api Version Forbidden | Доступ до цієї версії API заборонено для вашого ключа |
| `5011` | Query Param Forbidden | Доступ до запитаних query-параметрів заборонено |
| `5012` | Discord Id Not Found | Discord ID не знайдено в базі даних |
| `5013` | Token Not Found | Токен не знайдено |
| `5014` | Token Not Found Or Deleted | Токен не знайдено або його було видалено |
| `5015` | Command Queue Full | Черга команд заповнена. Спробуйте пізніше |
| `5016` | Rate Limit Exceeded | Перевищено ліміт запитів. Дочекайтеся скидання (див. `retry_after`) |
| `5017` | Internal Error | Внутрішня помилка сервера. Помилка логується |
| `5018` | Server Error | Помилка при зверненні до зовнішнього API. Дані можуть бути з кешу |
| `5019` | Prc Api Error | Помилка від PRC API. Див. поле `prc_code` для коду помилки PRC |
| `5020` | Not Found | Ендпоінт не знайдено. Перевірте URL запиту |
| `5021` | Webhook Url Already Exists | URL вебхука вже існує |
| `5022` | Webhook Not Found | Вебхук не знайдено |
| `5023` | Webhook Url Not Found | URL вебхука не знайдено |
| `5024` | Cache Expired | Кеш застарів та недоступний. Усі джерела даних повернули помилку |
| `5025` | Websocket Key Not Found | WebSocket ключ не знайдено |
| `5026` | Invalid Subscription Channel | Невірний канал підписки |
| `5034` | Invalid Json | Невірний формат JSON у тілі запиту |
| `5035` | Missing Signature Headers | Відсутні заголовки підпису (`X-Signature-Ed25519`, `X-Signature-Timestamp`) |
| `5036` | Timestamp Too Old | Таймстамп запиту занадто старий (понад 5 хвилин) |
| `5037` | Invalid Signature | Невірний підпис запиту |
| Код | Опис | Значення |
| ------ | ---------------------- | ------------------------------------------------ |
| `5101` | Invalid Message Format | Перевірте формат JSON та поле `action` |
| `5102` | Token Required | Додайте поле `token` у повідомлення `auth` |
| `5107` | Not Authenticated | Надішліть повідомлення `auth` перед іншими діями |
| `5108` | Invalid Token | Перевірте ваш WebSocket токен |
| `5109` | Connection Blocked | Зверніться до адміністратора |
| `5117` | Authentication Failed | Внутрішня помилка. Спробуйте пізніше |
| `5127` | Connected | Інформаційний код, дій не потрібно |
| `5128` | Auth Success | Інформаційний код, дій не потрібно |
| `5129` | Pong | Інформаційний код, дій не потрібно |
| `5130` | Subscription Denied | Немає прав на цей канал даних |
| `5131` | Subscribed | Інформаційний код, дій не потрібно |
| `5132` | Unsubscribed | Інформаційний код, дій не потрібно |
| `5133` | Cache Empty | Дані ще не завантажені, зачекайте |
| `5134` | Empty Snapshot | Кеш є, але немає даних для ваших підписок |
| Код | Опис | Значення |
| ------ | ------------------------------------------------ | ---------------------------------------------- |
| `6000` | Unknown Error Occurred | Перевірте логи, зверніться до адміністратора |
| `6001` | Database Error Occurred. Please Try Again Later. | Повторіть запит через кілька секунд |
| `6002` | Invalid Amount Specified. | Перевірте формат суми (має бути додатне число) |
| `6003` | Invalid Or Missing Parameters. | Перевірте обов'язкові поля в запиті |
| `6004` | Requested Resource Not Found. | Перевірте ID ресурсу |
| `6005` | Internal Server Error Occurred. | Повторіть запит пізніше |
| `6006` | Discord Operation Failed. | Перевірте права бота в Discord |
| `6007` | Data Serialization Error. | Зверніться до адміністратора |
| `6008` | Guild Not Found | Перевірте `guildId` у параметрах |
| `6009` | Discord Channel Not Found | Перевірте `channelId` у запиті |
| `6010` | Business Not Found | Перевірте `businessId` або `businessName` |
| `6011` | Mafia Not Found | Перевірте `mafiaId` або `mafiaName` |
| `6012` | Transaction Not Found | Перевірте `transactionId` |
| `6013` | Item Not Found | Перевірте `itemName` |
| `6014` | Request Not Found Or Expired | Перевірте `requestId` |
| `6015` | Duplicate Entry Found. | Ресурс уже існує |
| `6016` | User Not Found | Перевірте `userId` |
| `6017` | Insufficient Funds | Недостатньо коштів у користувача |
| `6018` | Invalid Action Specified | Перевірте параметр `action` |
| `6019` | Missing Required Fields | Заповніть усі обов'язкові поля |
| `6020` | Permission Denied | Перевірте токен та права доступу |
| `6021` | Rate Limit Exceeded | Дочекайтеся скидання ліміту |
## Таблиця Помилок ER:LC API
Ці коди помилок можуть повертатися від зовнішнього ER:LC API під час запитів до ендпоінтів `*/erlc/*`.
| Код | Значення |
| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `0` | Сталася невідома помилка. Якщо помилка повторюється, зверніться до підтримки ER:LC Росія через тікет (ми звернемося до підтримки PRC, якщо помилка виникає часто). |
| `1001` | Помилка зв'язку з Roblox або внутрішньоігровим приватним сервером. |
| `1002` | Сталася внутрішня системна помилка. |
| Код | Значення |
| ------ | ------------------------------------------------ |
| `2000` | Ви не надали server-key. |
| `2001` | Ви вказали server-key у невірному форматі. |
| `2002` | Ви надали недійсний або прострочений server-key. |
| `2003` | Ви надали недійсний глобальний API-ключ. |
| `2004` | Ваш server-key заблоковано для доступу до API. |
| Код | Значення |
| ------ | ---------------------------------------------------------------------------- |
| `3001` | Ви не вказали коректну команду в тілі запиту. |
| `3002` | Сервер, до якого ви намагаєтеся звернутися, наразі вимкнено (немає гравців). |
| Код | Значення |
| ------ | ------------------------------------------------------- |
| `4001` | Перевищено ліміт запитів. |
| `4002` | Команда, яку ви намагаєтеся виконати, обмежена. |
| `4003` | Повідомлення, яке ви намагаєтеся надіслати, заборонено. |
| Код | Значення |
| ------ | ---------------------------------------------- |
| `9998` | Ресурс, до якого ви звертаєтеся, обмежений. |
| `9999` | Модуль на внутрішньоігровому сервері застарів. |
## Обробка Коду `0`
Якщо ви отримуєте помилку з кодом `0` (Unknown Error) і вона повторюється при кількох запитах поспіль, створіть тікет на нашому Discord-сервері. Прикріпіть до звернення деталі вашого запиту, щоб наша команда могла розібратися, у чому проблема.