Коди помилок та довідник статусів

Детальний посібник із кодів помилок Smart Money API, кодів статусу HTTP та кроків для вирішення проблем. Зрозумійте відповіді на помилки та швидко вирішуйте проблеми інтеграції.

Коди успіху 2xx

Успішні відповіді вказують на те, що запит був успішно оброблений.

Код	Статус	Значення
200	OK	Запит успішний. Тіло відповіді містить затребувані дані.
201	Створено	Ресурс успішно створено. Відповідь містить новий ресурс.
204	Немає вмісту	Запит успішний, але немає вмісту для повернення (наприклад, DELETE).

Приклад відповіді 200

JSON

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

Коди помилок клієнта 4xx

Помилки клієнта вказують на те, що запит був неправильно сформований або недійсний. Виправте ваш запит і повторіть спробу.

Код	Статус	Причина
400	Неправильний запит	Неправильний синтаксис запиту. Перевірте параметри запиту, заголовки та тіло запиту.
401	Неавторизовано	Відсутні або недійсні облікові дані автентифікації. Перевірте ваш API-ключ або JWT-токен.
402	Потрібна оплата	Ваш платіж за підписку не вдався. Оновіть платіжну інформацію у вашому обліковому записі.
403	Заборонено	Автентифіковано, але немає доступу до цього ресурсу. Ваш план не включає цю функцію.
404	Не знайдено	Ресурс не існує. Перевірте URL кінцевої точки та параметри.
429	Забагато запитів	Перевищено ліміт швидкості. Зачекайте перед повторною спробою. Перевірте заголовок Retry-After.
422	Необроблюваний об’єкт	Валідація не вдалася. Параметри запиту недійсні або відсутні обов’язкові поля.

Приклади помилок автентифікації

Відсутній 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 Забагато запитів. Перевірте заголовки відповіді для отримання інформації про обмеження швидкості:

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	Внутрішня помилка	Неочікувана помилка сервера. Повторіть спробу з експоненційним відступом.
502	Поганий шлюз	Тимчасова перерва в обслуговуванні. Повторіть спробу через кілька секунд.
503	Сервіс недоступний	Технічне обслуговування або тимчасова перерва. Перевірте сторінку статусу. Повторіть спробу після інтервалу Retry-After.
504	Тайм-аут шлюзу	Запит зайняв занадто багато часу. Сервер, можливо, все ж обробив його. Перевірте ідемпотентність.

Приклад помилки сервера (503)

JSON

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

Посібник із вирішення проблем

401 Неавторизовано - Недійсний API-ключ

Проблема: Отримання помилок 401 навіть з API-ключем.

Рішення:

Перевірте, чи API-ключ включений у заголовок Authorization з префіксом "Bearer"
Перевірте, чи ваш API-ключ не закінчився або не був відкликаний
Переконайтеся, що ви використовуєте правильний ключ (продукція, тестування або розробка)
Згенеруйте новий API-ключ у вашій консолі, якщо поточний втрачено

403 Заборонено - Функція недоступна

Проблема: Отримання помилок 403 на певних кінцевих точках.

Рішення:

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

429 Забагато запитів - Обмеження швидкості

Проблема: Отримання помилок 429 та обмеження швидкості.

Рішення:

Реалізуйте логіку повторних спроб із експоненційним відступом (чекайте 1с, 2с, 4с тощо)
Кешуйте відповіді, щоб уникнути надмірних API-запитів
Використовуйте WebSocket для отримання даних у реальному часі замість опитування REST-кінцевих точок
Оновіть ваш план для більших квот (Trader 1,000/день, Pro 5,000/день)
Об’єднуйте кілька запитів в один, де це можливо

400 Невірний запит - Невірні параметри

Проблема: Отримання помилок 400 із неправильно сформованими запитами.

Рішення:

Перевірте документацію API на наявність обов’язкових та опціональних параметрів
Перевірте типи параметрів (рядки проти чисел, масиви проти об’єктів)
Переконайтеся, що 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

Отримати підтримку

Маєте запитання? Перегляньте нашу документацію або зверніться до підтримки.

Відкрити консоль