Формат відповіді про помилку
Усі помилки повертаються у форматі JSON із полямиcode та message.
Наприклад:
{
"code": 5007,
"message": "Missing Token"
}
Таблиця помилок API ER:LC Росія
Помилки авторизації та токенів
Помилки авторизації та токенів
| Код | Опис | Значення |
|---|---|---|
5006 | Invalid Master Key | Недійсний майстер-ключ. Перевірте заголовок erlcrussia-api-master-key |
5007 | Missing Token | Відсутній токен авторизації. Додайте заголовок Authorization: Bearer <токен> або erlcrussia-api-key: <токен> |
5008 | Invalid Token | Токен недійсний, вимкнений або видалений |
5033 | Unauthorized | Немає дійсної сесії або ключа для цього маршруту |
5009 | Forbidden | Доступ до цього ендпоінта або дії заборонено для вашого токена |
5010 | Api Version Forbidden | Ключу заборонено доступ до цієї версії API |
5011 | Query Param Forbidden | Доступ до вказаних query-параметрів заборонено політикою прав ключа |
5037 | Invalid Signature | Недійсний ED25519 цифровий підпис запиту |
Помилки запитів та ресурсів
Помилки запитів та ресурсів
| Код | Опис | Значення |
|---|---|---|
5001 | Missing Discord Id | Відсутній discord_id. Додайте поле discord_id у тіло запиту |
5002 | Missing Parameters | Відсутні обов’язкові параметри. Перевірте параметри запиту |
5003 | Invalid Version | Невірна версія API у маршруті. Використовуйте актуальну версію v3 |
5004 | Invalid Param Name | Невірне ім’я query-параметра |
5005 | Missing Command | Не передано команду. Додайте поле command у тіло запиту |
5012 | Discord Id Not Found | Користувача з цим Discord ID не знайдено |
5013 | Token Not Found | Токен не знайдено |
5014 | Token Not Found Or Deleted | Токен не знайдено або видалено |
5020 | Not Found | Запитаний ресурс або ендпоінт не знайдено |
5021 | Webhook Url Already Exists | URL вебхука вже зареєстровано в системі |
5022 | Webhook Not Found | Вебхук не знайдено |
5023 | Webhook Url Not Found | URL вебхука не знайдено |
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 хвилин) |
5038 | Insufficient AI Credits | Недостатньо кредитів AI на балансі для виконання запиту |
5040 | Model Not Found | Запитану модель нейромережі не знайдено |
5041 | Asset Not Found | CDN ресурс не знайдено |
5042 | Folder Not Found | Папку CDN не знайдено |
5043 | Item Not Found | Запитаний товар або елемент не знайдено |
5044 | User Not Found | Користувача не знайдено |
5045 | Insufficient Balance | Недостатньо коштів на балансі |
5046 | Order Not Found | Замовлення не знайдено |
5047 | Points Limit Exceeded | Перевищено добовий ліміт нарахування балів |
5048 | Insufficient Points | Недостатньо балів для виконання дії |
5050 | Roblox Account Not Linked | Акаунт Roblox не прив’язано до Discord |
5051 | Webhook Verification Failed | URL вебхука не пройшов перевірку підпису. Причина — у полі reason: private_host, unreachable, signed_rejected, forged_accepted, signing_unavailable |
Помилки сервера, черги та лімітів
Помилки сервера, черги та лімітів
| Код | Опис | Значення |
|---|---|---|
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 |
5024 | Cache Expired | Кеш застарів і тимчасово недоступний |
5028 | Endpoint is deprecated | Ендпоінт застарів. Використовуйте актуальну версію API V3 |
5039 | Spam Blocked | Запит заблоковано спам-фільтром |
5049 | Bad Gateway | Шлюз недоступний під час звернення до сервісу |
Помилки WebSocket Gateway
Помилки WebSocket Gateway
| Код | Опис | Значення |
|---|---|---|
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 | Кеш є, але немає даних для ваших підписок |
Помилки CDN та AI Gateway
Помилки CDN та AI Gateway
| Код | Опис | Значення |
|---|---|---|
5135 | CDN Path Already Exists | Шлях до файлу вже зайнятий. Автоматичний перезапис вимкнено |
5136 | CDN Folder Slug Already Exists | Slug папки вже зайнятий. Оберіть інший ідентифікатор папки |
5137 | CDN Folder Not Found | Папку CDN із зазначеним ID не знайдено |
5138 | CDN Storage Unavailable | Сховище CDN тимчасово недоступне |
5139 | CDN Source Unavailable | Зовнішнє джерело не повернуло файл під час імпорту |
5140 | AI Response Unavailable | Модель AI не повернула коректну відповідь |
5141 | AI Model Unavailable | Модель AI тимчасово недоступна |
Помилки API економіки
Помилки API економіки
| Код | Опис | Значення |
|---|---|---|
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
Ці коди помилок повертаються від зовнішнього PRC Private Server API під час запитів до ендпоінтів*/erlc/*.
Системні помилки
Системні помилки
| Код | Значення |
|---|---|
0 | Сталася невідома помилка. Якщо помилка повторюється, зверніться в підтримку ER:LC Росія через тікет. |
1001 | Помилка зв’язку з Roblox або внутрішньоігровим приватним сервером. |
1002 | Сталася внутрішня системна помилка PRC. |
Помилки автентифікації
Помилки автентифікації
| Код | Значення |
|---|---|
2000 | Ви не надали server-key. |
2001 | Ви вказали server-key у некоректному форматі. |
2002 | Ви надали недійсний або минулий server-key. |
2003 | Ви надали недійсний глобальний API-ключ. |
2004 | Ваш server-key заблоковано для доступу до API. |
2005 | Ви надсилаєте неавтентифіковані запити від імені кількох серверів. Створіть публічний додаток та передавайте його API-ключ у заголовку Authorization. |
Помилки запитів
Помилки запитів
| Код | Значення |
|---|---|
3001 | Ви не вказали коректну команду в тілі запиту. |
3002 | Сервер, до якого ви намагаєтесь звернутися, зараз відключений (немає гравців). |
Помилки лімітів та доступу
Помилки лімітів та доступу
| Код | Значення |
|---|---|
4000 | У вас немає дозволу на виконання цієї дії на цьому сервері. |
4001 | Перевищено ліміт запитів або тимчасове блокування. Перевірте Retry-After. |
4002 | Команда, яку ви намагаєтесь виконати, обмежена. |
4003 | Повідомлення, яке ви намагаєтесь надіслати, заборонено політикою фільтрації. |
Спеціальні коди
Спеціальні коди
| Код | Значення |
|---|---|
9998 | Ресурс, до якого ви звертаєтесь, обмежений. |
9999 | Модуль на внутрішньоігровому сервері ER:LC застарів. |
Обробка коду 9999
Код помилки 9999 означає, що модуль на внутрішньоігровому приватному сервері ER:LC застарів. Щоб вирішити проблему, кікніть усіх гравців із приватного сервера, щоб він оновив модуль, і повторіть запит.
Обробка коду 0
Якщо ви ловите помилку з кодом 0 (Unknown Error) і вона повторюється при кількох запитах поспіль, створіть тікет на нашому Discord-сервері. Додайте до звернення деталі запиту, щоб наша команда могла розібратися.