Формат ответа об ошибке
Все ошибки возвращаются в формате 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 Россия через тикет (мы передадим информацию разработчикам PRC). |
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 | Превышен лимит запросов (Rate limit) или временная блокировка. Проверьте заголовок Retry-After. |
4002 | Команда, которую вы пытаетесь выполнить, ограничена или запрещена. |
4003 | Сообщение, которое вы пытаетесь отправить, запрещено политикой фильтрации. |
Специальные коды
Специальные коды
| Код | Значение |
|---|---|
9998 | Ресурс, к которому вы обращаетесь, ограничен. |
9999 | Модуль на внутриигровом сервере ER:LC устарел. |
Обработка кода 9999
Код ошибки 9999 означает, что модуль на внутриигровом приватном сервере ER:LC устарел. Для решения проблемы кикните всех игроков с приватного сервера, чтобы сервер перезапустился и обновил модуль, после чего повторите запрос.
Обработка кода 0
Если вы ловите ошибку с кодом 0 (Unknown Error) и она повторяется при нескольких запросах подряд, создайте тикет на нашем Discord-сервере. Прикрепите к обращению детали вашего запроса, чтобы наша команда могла разобраться, в чём проблема.