← Назад
referenceСередній⏱️ 4 хв читання

Ліміти на використання та квоти

Ліміти кількості запитів для автентифікованих і неавтентифікованих запитів, заголовки відповіді та обробка помилки перевищення ліміту.

#rate-limits#reference

Ліміти запитів

Для запитів з автентифікацією (по сесії або API-ключу) можна зробити до 10 000 запитів на годину. Автентифіковані запити асоціюються з контрагентом користувача незалежно від типу токена, що використовується — усі застосунки й браузери, авторизовані одним користувачем, ділять єдину квоту в 10 000 запитів на годину, навіть якщо використовують різні токени цього самого користувача.

Для неавтентифікованих запитів ліміт становить 120 запитів на годину. Такі запити асоціюються з IP-адресою, з якої вони надходять.

Заголовки відповіді

Заголовки будь-якої відповіді API повертають ваш поточний стан ліміту:

curl -i -H "User-Agent: <НазваВашогоЗастосунку>/1.0" https://api.bm.parts/profile/me
HTTP/1.1 200 OK
Date: Mon, 01 Jul 2026 17:27:06 GMT
Status: 200 OK
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 56
X-RateLimit-Reset: 1372700873
ЗаголовокОпис
X-RateLimit-LimitМаксимальна кількість запитів, які можна зробити за годину.
X-RateLimit-RemainingКількість запитів, що залишились доступними в поточному вікні.
X-RateLimit-ResetЧас, коли поточний лічильник обнулиться, у форматі Unix timestamp (UTC).

Якщо потрібен час в іншому форматі — підійде будь-яка сучасна мова програмування. Наприклад, у консолі браузера час скидання легко отримати як об’єкт JavaScript Date:

new Date(1519173436 * 1000)
// => Wed Feb 21 2018 02:37:16 GMT+0200

Перевищення ліміту

Якщо ліміт запитів перевищено, у відповідь повертається помилка:

HTTP/1.1 403 Forbidden
Date: Tue, 20 Aug 2013 14:50:41 GMT
Status: 403 Forbidden
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1377013266

{
  "message": "Перевищено ліміт запитів API для xxx.xxx.xxx.xxx.",
  "documentation_url": "https://developer.bm.parts/"
}

Примітка: ніколи не передавайте свій API-ключ чи пароль і не використовуйте їх у публічній частині застосунку. Використовуйте їх лише при взаємодії сервер-сервер.

Як залишатись у межах ліміту

Якщо ви регулярно перевищуєте ліміт запитів, найімовірніше вирішення — кешувати відповіді API замість того, щоб повторно запитувати ті самі дані.

Пошук

Пошук ендпоінтів, гайдів, туторіалів, реліз-ноутів по всьому порталу