Доступные методы
Коды ошибок
Справочник кодов ошибок API.
Обзор
При возникновении ошибки API возвращает ответ в следующем формате:
{
status: false
statusCode: number // HTTP код ответа
errorCode: number // Внутренний код ошибки
message: string // Описание ошибки
}Таблица кодов ошибок
| errorCode | message | Описание |
|---|---|---|
| 0 | ACCESS_DENIED | Нет доступа / неверный токен |
| 1 | NOT_FOUND | Ресурс не найден |
| 2 | USER_NOT_FOUND | Пользователь не найден |
| 3 | BAD_REQUEST | Неверный запрос |
| 4 | AUTH_PARAMS_NOT_VALID | Неверные параметры авторизации |
| 5 | LOCATION_NOT_FOUND | Локация не найдена |
| 6 | PROMOCODE_NOT_FOUND | Промокод не найден |
| 7 | ALREADY_EXISTS | Ресурс уже существует |
| 8 | ENTER_LOGIN_INSTEAD_PROMOCODE | Введите логин вместо промокода |
| 9 | NO_AVAILABLE_SERVERS | Нет доступных серверов |
| 10 | LOCATION_NOT_ACTIVE | Локация неактивна |
| 11 | ITS_YOUR_KEY | Это ваш ключ |
| 12 | TELEGRAM_NOT_CONNECTED | Telegram не подключён |
| 13 | PROMOCODE_RENEW_ONLY | Промокод только для продления |
| 14 | PROMOCODE_NEW_ACCOUNTS_ONLY | Промокод только для новых аккаунтов |
| 15 | REFERRAL_BALANCE_NOT_ENOUGH | Недостаточно реферального баланса |
| 16 | PROMOCODE_INVALID_PRODUCT_TYPE | Неверный тип продукта для промокода |
| 17 | TARIFF_NOT_AVAILABLE_FOR_LOCATION | Тариф недоступен для локации |
| 18 | PASSKEY_NOT_FOUND | Passkey не найден |
| 19 | PASSKEY_ALREADY_EXISTS | Passkey уже существует |
| 20 | PASSKEY_VERIFICATION_FAILED | Ошибка проверки passkey |
| 21 | PASSKEY_LIMIT_REACHED | Достигнут лимит passkey |
| 22 | MAGIC_LINK_RATE_LIMITED | Ограничение частоты magic link |
| 23 | MAGIC_LINK_HOURLY_LIMIT_EXCEEDED | Превышен часовой лимит magic link |
| 24 | MAGIC_LINK_EXPIRED | Magic link истёк |
| 25 | MAGIC_LINK_ALREADY_USED | Magic link уже использован |
| 26 | MAGIC_LINK_NOT_FOUND | Magic link не найден |
| 27 | CUSTOM_SUBSCRIPTION_NOT_FOUND | Кастомная подписка не найдена |
| 28 | CUSTOM_SUBSCRIPTION_LIMIT_REACHED | Достигнут лимит кастомных подписок |
| 29 | CUSTOM_SUBSCRIPTION_ITEM_NOT_FOUND | Элемент кастомной подписки не найден |
| 30 | CUSTOM_SUBSCRIPTION_INVALID_ITEM | Неверный элемент кастомной подписки |
| 31 | CONFIG_TITLE_NOT_FOUND | Название конфига не найдено |
| 32 | CONFIG_INDEX_OUT_OF_RANGE | Индекс конфига вне диапазона |
| 33 | API_KEY_NOT_FOUND | API ключ не найден |
| 34 | API_KEY_LIMIT_REACHED | Достигнут лимит API ключей (5) |
| 35 | SERVER_NOT_FOUND | Сервер не найден |
| 36 | NO_SERVERS_AVAILABLE_FOR_MIGRATION | Нет серверов для миграции |
| 37 | INSUFFICIENT_CAPACITY_FOR_MIGRATION | Недостаточная ёмкость для миграции |
| 38 | USER_BANNED | Пользователь заблокирован |
| 39 | TROJAN_REQUIRES_EXTENDED_SETTINGS | Trojan требует расширенных настроек |
| 40 | DEVICE_NOT_FOUND | Устройство не найдено |
| 41 | DEVICE_LIMIT_REACHED | Достигнут лимит устройств |
| 42 | DEVICE_BLOCKED | Устройство заблокировано |
| 43 | UNKNOWN_DEVICE_NOT_ALLOWED | Неизвестное устройство не разрешено |
| 44 | PROMOCODE_NOT_ALLOWED_WITH_PRICING_RULE | Промокод не разрешён с правилом ценообразования |
| 45 | BALANCE_NOT_ENOUGH | Недостаточный баланс |
| 46 | INVALID_TOPUP_AMOUNT | Неверная сумма пополнения |
| 47 | INVALID_RENEWAL_DAYS | Неверное количество дней продления |
| 48 | EXPIRED | Ресурс истёк |
| 49 | PAID_OPTION_CONFIG_NOT_FOUND | Конфиг платной опции не найден |
| 50 | NO_SERVERS_FOR_PAID_OPTION | Нет серверов для платной опции |
| 51 | PAID_OPTION_CONFIG_LIMIT_REACHED | Достигнут лимит конфигов платной опции |
HTTP коды ответов
| HTTP код | Описание |
|---|---|
| 200 | Успешный запрос |
| 201 | Ресурс успешно создан |
| 400 | Неверный запрос (bad request) |
| 401 | Не авторизован |
| 403 | Доступ запрещён |
| 404 | Ресурс не найден |
| 429 | Превышен лимит запросов |
| 500 | Внутренняя ошибка сервера |
Примеры ошибок
Неверный API ключ
{
"status": false,
"statusCode": 401,
"errorCode": 0,
"message": "ACCESS_DENIED"
}Конфигурация не найдена
{
"status": false,
"statusCode": 404,
"errorCode": 1,
"message": "NOT_FOUND"
}Превышен лимит запросов
{
"status": false,
"statusCode": 429,
"message": "Too Many Requests"
}Неверные параметры запроса
{
"status": false,
"statusCode": 400,
"errorCode": 3,
"message": "BAD_REQUEST"
}Рекомендации
При получении ошибки 429 Too Many Requests рекомендуется подождать 60 секунд перед повторным запросом.
Ошибка errorCode: 0 может означать как неверный API ключ, так и попытку доступа к ресурсу без прав.
Помогла ли вам эта статья?