Справочник кодов ошибок и статусов

Полное руководство по кодам ошибок Smart Money API, HTTP-статусам и шагам по устранению неполадок. Разберитесь в ответах об ошибках и быстро решайте проблемы интеграции.

Коды успеха 2xx

Успешные ответы означают, что запрос был обработан успешно.

Код	Статус	Значение
200	OK	Запрос выполнен успешно. Тело ответа содержит запрошенные данные.
201	Created	Ресурс успешно создан. Ответ включает новый ресурс.
204	No Content	Запрос выполнен успешно, но возвращать нечего (например, DELETE).

Пример ответа 200

JSON

{
  "success": true,
  "data": {
    "total": 42,
    "positions": [...],
    "pagination": {
      "page": 1,
      "limit": 50
    }
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Коды ошибок клиента 4xx

Ошибки клиента означают, что запрос составлен некорректно или недействителен. Исправьте запрос и повторите попытку.

Код	Статус	Причина
400	Bad Request	Некорректный синтаксис запроса. Проверьте параметры запроса, заголовки и тело запроса.
401	Unauthorized	Отсутствуют или недействительны учётные данные аутентификации. Проверьте API-ключ или JWT-токен.
402	Payment Required	Ошибка оплаты подписки. Обновите платёжные данные в аккаунте.
403	Forbidden	Аутентификация пройдена, но доступ к ресурсу запрещён. Ваш тариф не включает эту функцию.
404	Not Found	Ресурс не существует. Проверьте URL конечной точки и параметры.
429	Too Many Requests	Превышен лимит запросов. Подождите перед повторной попыткой. Проверьте заголовок Retry-After.
422	Unprocessable Entity	Ошибка валидации. Параметры запроса недействительны или отсутствуют обязательные поля.

Примеры ошибок аутентификации

Отсутствует API-ключ (401)

JSON

{
  "success": false,
  "error": {
    "code": "AUTH_MISSING_KEY",
    "message": "Учётные данные аутентификации не предоставлены.",
    "resolution": "Добавьте API-ключ в заголовок Authorization: Authorization: Bearer sk_live_..."
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Недействительный API-ключ (401)

JSON

{
  "success": false,
  "error": {
    "code": "AUTH_INVALID_KEY",
    "message": "Недействительный или просроченный API-ключ.",
    "resolution": "Сгенерируйте новый API-ключ в консоли: https://smartmoneyapi.com/console"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Ограничение частоты запросов (429)

При превышении квоты API сервер возвращает 429 Too Many Requests. Проверьте заголовки ответа для информации о лимитах:

HTTP-заголовки

X-Requests-Remaining: 0
X-Requests-Limit: 200
X-Requests-Reset: 1711116922
Retry-After: 3600

Ответ об ошибке лимита запросов

JSON

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Превышен дневной лимит запросов API (10).",
    "resolution": "Перейдите на тариф Trader ($29/мес, 1,000 запросов/день) или Pro ($79/мес, 5,000 запросов/день).",
    "reset_at": "2026-03-22T09:00:00Z"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Ошибки валидации (422)

Ошибки валидации возникают, если параметры запроса недействительны или отсутствуют обязательные поля.

JSON

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Ошибка валидации запроса.",
    "details": [
      {
        "field": "symbol",
        "error": "Неверная торговая пара. Ожидаемый формат: BTCUSDT"
      },
      {
        "field": "min_position_size",
        "error": "Должно быть положительным числом"
      }
    ],
    "resolution": "Исправьте ошибки валидации и повторите попытку."
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Коды ошибок сервера 5xx

Ошибки сервера указывают на проблему на нашей стороне. Они временные и обычно быстро устраняются. Реализуйте логику повторных попыток с экспоненциальной задержкой.

Код	Статус	Действие
500	Internal Error	Неожиданная ошибка сервера. Повторите попытку с экспоненциальной задержкой.
502	Bad Gateway	Временный перерыв в работе сервиса. Повторите попытку через несколько секунд.
503	Service Unavailable	Техническое обслуживание или временный сбой. Проверьте страницу статуса. Повторите попытку после интервала Retry-After.
504	Gateway Timeout	Запрос выполнялся слишком долго. Сервер мог его обработать. Проверьте идемпотентность.

Пример ошибки сервера (503)

JSON

{
  "success": false,
  "error": {
    "code": "SERVICE_UNAVAILABLE",
    "message": "Сервис временно недоступен из-за технического обслуживания.",
    "resolution": "Повторите попытку через 5 минут. Отслеживайте статус на https://status.smartmoneyapi.com"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Руководство по устранению неполадок

401 Unauthorized — недействительный API-ключ

Проблема: Получаете ошибки 401, даже с API-ключом.

Решения:

Убедитесь, что API-ключ указан в заголовке Authorization с префиксом "Bearer"
Проверьте, не истёк ли срок действия API-ключа или он не был отозван
Убедитесь, что используется правильный ключ (рабочий, тестовый или разработки)
Сгенерируйте новый API-ключ в консоли, если текущий утерян

403 Forbidden — функция недоступна

Проблема: Получаете ошибки 403 на определённых конечных точках.

Решения:

Проверьте свой тариф API. Некоторые конечные точки требуют тарифов Trader или Pro
Перейдите на другой тариф на /pricing.html для доступа к премиум-функциям
Убедитесь, что API-ключ имеет необходимые разрешения
Обратитесь в поддержку, если считаете, что доступ должен быть предоставлен

429 Too Many Requests — ограничение частоты запросов

Проблема: Получаете ошибки 429 из-за ограничения частоты запросов.

Решения:

Реализуйте логику повторных попыток с экспоненциальной задержкой (1с, 2с, 4с и т.д.)
Кэшируйте ответы, чтобы избежать избыточных вызовов API
Используйте WebSocket для получения данных в реальном времени вместо опроса REST-конечных точек
Перейдите на тариф с более высокой квотой (Trader 1,000/день, Pro 5,000/день)
Объединяйте несколько запросов в один, где это возможно

400 Bad Request — неверные параметры

Проблема: Получаете ошибки 400 из-за некорректных запросов.

Решения:

Проверьте документацию API на наличие обязательных и необязательных параметров
Убедитесь в правильности типов параметров (строки vs числа, массивы vs объекты)
Проверьте, что JSON валиден и правильно отформатирован
Используйте правильные URL конечных точек с корректными параметрами пути
Проверьте наличие опечаток в именах параметров запроса

Ошибки сервера 5xx — временные сбои

Проблема: Получаете ошибки 500, 502, 503 или 504.

Решения:

Проверьте статус сервиса на https://status.smartmoneyapi.com
Реализуйте автоматический повтор с экспоненциальной задержкой (максимум 5-10 попыток)
Подождите 30-60 секунд перед повторной попыткой при ошибках 503
Используйте заголовок Retry-After для определения времени повторной попытки
Подпишитесь на страницу статуса для уведомлений об инцидентах

Формат ответа с ошибкой

Все ответы с ошибками следуют единому формату:

JSON

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Человекочитаемое сообщение об ошибке",
    "details": {...},
    "resolution": "Шаги для решения проблемы"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

Нужна дополнительная помощь?

Проверьте нашу документацию по API или свяжитесь с поддержкой, указав код ошибки и детали запроса.

Справочник API

Получить поддержку

Есть вопросы? Проверьте нашу документацию или обратитесь в поддержку.

Открыть консоль