Ограничения частоты запросов | Документация

Ваш тариф задаёт месячную квоту запросов и посекундное ограничение частоты запросов; при превышении любого из них возвращается 429. На этой странице описаны уровни тарифов, посекундные ограничения, заголовки ответа, сообщающие о лимитах, цены на превышение квоты, ограничения на количество слотов вебхуков, а также уровни путей для исторических данных ADS-B, которые определяют окна хранения данных.

Квота контролируется в разных местах для двух каналов —

О правилах повторных попыток при 429 см. Обработка ошибок → Правила повторных попыток. О подписке и подаче заявки на пробный период см. Начало работы.

Тарифы

Тариф FREE Trial нельзя оформить самостоятельно — подайте заявку на skylinkapi.com/apply. Платные тарифы доступны на нашей странице оформления заказа или на странице SkyLink API в RapidAPI. Цены и квоты одинаковы для обоих каналов; стоимость превышения квоты на тарифе Pro различается (см. таблицу для вашего канала). Сравнить тарифы можно на skylinkapi.com/pricing.

Тариф	Цена	Запросов в месяц	Превышение квоты	Вебхуки	Исторические данные ADS-B (макс. окно на запрос)
FREE Trial	Бесплатно	1000	$0.007/запрос	—	—
Basic	$19/мес. или $16/мес. при оплате за год ($192/год)	5000	$0.007/запрос	—	—
Pro	$59/мес. или $49/мес. при оплате за год ($588/год)	20 000	$0.001/запрос	1	90 дней — только `/ultra/history/...`
Business	Скоро	Индивидуально	Индивидуально	10	365 дней
Enterprise	Свяжитесь с нами	200 000 – без ограничений	Индивидуально	Индивидуально	Индивидуально

Сменить тариф, отменить подписку или проверить использование можно в вашем клиентском портале Polar.

Все цены указаны в долларах США без учёта НДС и налога с продаж.

Устаревшие тарифы (Ultra и Mega)

Тарифы Ultra и Mega больше не продаются новым подписчикам. Действующие подписчики сохраняют свой тариф, цену и лимиты:

Тариф	Цена	Запросов в месяц	Превышение квоты	Вебхуки	Исторические данные ADS-B (макс. окно на запрос)
Ultra	$105.59/мес.	70 000	$0.002/запрос	3	90 дней на `/ultra/...` или 365 дней на `/mega/...`
Mega	$205.39/мес.	200 000	$0.0005/запрос	10	90 дней на `/ultra/...` или 365 дней на `/mega/...`

Глубина ретроспективы на один запрос для исторических данных ADS-B (архивные данные о местоположении воздушных судов глубиной до 365 дней) определяется префиксом URL-пути, а не только названием тарифа. Используйте /ultra/history/... для окон до 90 дней и /mega/history/... — до 365 дней (только Ultra и Mega). См. раздел Уровни путей для исторических данных ADS-B ниже.

Посекундные ограничения частоты запросов

У каждого тарифа также есть посекундное ограничение. Частота — это устойчивое количество запросов в секунду; всплеск (burst) — это количество дополнительных запросов, которые могут поступить одновременно сверх этой частоты, прежде чем последующие запросы будут отклонены с кодом 429.

Тариф	Частота	Всплеск
FREE Trial	1 запрос/с	0 — строго один запрос в секунду
Basic	2 запроса/с	1
Pro	10 запросов/с	9

Эти ограничения действуют для всех аккаунтов, включая клиентов, оформивших подписку до изменения тарифов в октябре 2026 года. Действующие подписчики сохраняют цену, по которой они подписались, но на ограничения частоты запросов это не распространяется. Если вы отправляете запросы параллельно — пакетные задания, тайлы карт, вызовы инструментов агентами, — ограничивайте их частоту на стороне клиента, чтобы не превышать лимит вашего тарифа, и воспринимайте 429 как сигнал снизить нагрузку.

Нужна более высокая устойчивая частота? Свяжитесь с нами, чтобы узнать о лимитах тарифов Business и Enterprise.

Заголовки квоты

Каждый успешный ответ содержит следующие заголовки:

Заголовок	Значение
`X-RateLimit-Requests-Limit`	Предельное количество запросов для текущего окна
`X-RateLimit-Requests-Remaining`	Оставшееся количество запросов в этом окне
`X-RateLimit-Requests-Reset`	Количество секунд до сброса окна

Эти заголовки сообщают о защитном пороге от злоупотреблений, а не о вашей месячной квоте по тарифу. Этот порог — жёсткий суточный лимит, установленный значительно выше обычного уровня использования; он нужен, чтобы ограничить ущерб от скомпрометированного или вышедшего из-под контроля ключа. Не используйте эти заголовки для расчёта оставшейся оплаченной квоты или суммы счёта — проверяйте использование относительно вашего тарифа в клиентском портале Polar.

Запросы, которые достигают API и проходят аутентификацию, учитываются в вашем лимите, включая те, что завершаются ошибкой из-за ваших входных данных (например, 404 или 422). Запросы, отклонённые из-за отсутствующего или недействительного ключа, не учитываются.

429 — превышен лимит запросов

При достижении лимита вы получите:

{ "message": "Too many requests" }

Это происходит, когда вы исчерпали месячную квоту или превысили посекундное ограничение частоты запросов вашего тарифа. Используйте экспоненциальную задержку (backoff) и повторите запрос. Полную таблицу повторных попыток и вспомогательную функцию на Python см. в разделе Обработка ошибок → Правила повторных попыток.

Уровни путей для исторических данных ADS-B

Эндпоинты исторических данных ADS-B используют префиксы URL-пути, соответствующие окнам хранения данных, — эти префиксы не являются названиями тарифов RapidAPI:

Префикс URL-пути	Доступен на тарифах	Макс. окно на запрос
`/ultra/history/...`	Pro, Ultra, Mega	90 дней (контролируется сервером)
`/mega/history/...`	Ultra, Mega	365 дней

Подписчики Ultra и Mega могут вызывать любой из префиксов. Используйте /ultra/history/... для недавних окон (≤90 дней) и /mega/history/..., когда нужна более глубокая ретроспектива или более высокие лимиты на запрос. Подписчикам Pro доступен только /ultra/history/....

Важно: выбор неподходящего для вашего тарифа или диапазона дат префикса приводит к ответу шлюза 401/403 или ошибке валидации 422, а не к ошибке квоты 429. Ошибки ограничения доступа по тарифу описаны на главной странице исторических данных ADS-B.

Подробности об эндпоинтах и примеры интеграции см. в разделе Исторические данные ADS-B.