# Ограничения частоты запросов

Квоты тарифов, посекундные ограничения частоты запросов, заголовки ответа с лимитами, цены на превышение квоты и уровни путей исторических данных ADS-B.



Ваш тариф задаёт месячную квоту запросов и посекундное ограничение частоты запросов; при превышении любого из них возвращается `429`. На этой странице описаны уровни тарифов, [посекундные ограничения](#per-second-limits), заголовки ответа, сообщающие о лимитах, цены на превышение квоты, ограничения на количество слотов вебхуков, а также уровни путей для исторических данных [ADS-B](https://www.faa.gov/air_traffic/technology/adsb), которые определяют окна хранения данных.

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

О правилах повторных попыток при `429` см. [Обработка ошибок → Правила повторных попыток](/docs/errors#retry-rules). О подписке и подаче заявки на пробный период см. [Начало работы](/docs/getting-started).

<a id="plans" />

## Тарифы [#plans]

Тариф **FREE Trial** нельзя оформить самостоятельно — [подайте заявку на skylinkapi.com/apply](https://skylinkapi.com/apply/). Платные тарифы доступны на [нашей странице оформления заказа](https://buy.polar.sh/polar_cl_ELkXgbbG4kqTfypfbxTmPpoz8cb4sHCVgvZOo1zvPmk) или на [странице SkyLink API в RapidAPI](https://rapidapi.com/skylink-api-skylink-api-default/api/skylink-api/pricing). Цены и квоты одинаковы для обоих каналов; стоимость превышения квоты на тарифе Pro различается (см. таблицу для вашего канала). Сравнить тарифы можно на [skylinkapi.com/pricing](https://skylinkapi.com/pricing/).

<ForProvider only="direct">
  | Тариф      | Цена                                               | Запросов в месяц          | Превышение квоты | Вебхуки       | Исторические данные 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 | [Свяжитесь с нами](/enterprise)                    | 200 000 – без ограничений | Индивидуально    | Индивидуально | Индивидуально                                    |

  Сменить тариф, отменить подписку или проверить использование можно в вашем [клиентском портале Polar](https://polar.sh/skylink-api/portal/).
</ForProvider>

<ForProvider only="rapidapi">
  | Тариф      | Цена                            | Запросов в месяц          | Превышение квоты | Вебхуки       | Исторические данные ADS-B (макс. окно на запрос) |
  | ---------- | ------------------------------- | ------------------------- | ---------------- | ------------- | ------------------------------------------------ |
  | FREE Trial | Бесплатно                       | 1000                      | $0.007/запрос    | —             | —                                                |
  | Basic      | $19/мес.                        | 5000                      | $0.007/запрос    | —             | —                                                |
  | Pro        | $59/мес.                        | 20 000                    | $0.003/запрос    | 1             | 90 дней — только `/ultra/history/...`            |
  | Enterprise | [Свяжитесь с нами](/enterprise) | 200 000 – без ограничений | Индивидуально    | Индивидуально | Индивидуально                                    |

  Сменить тариф или управлять подпиской можно на странице [RapidAPI → SkyLink API](https://rapidapi.com/skylink-api-skylink-api-default/api/skylink-api/pricing).
</ForProvider>

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

<a id="legacy-plans" />

### Устаревшие тарифы (Ultra и Mega) [#legacy-plans-ultra-and-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/...` |

Глубина ретроспективы на один запрос для &#x2A;*исторических данных [ADS-B](https://www.faa.gov/air_traffic/technology/adsb)** (архивные данные о местоположении воздушных судов глубиной до 365 дней) определяется **префиксом URL-пути**, а не только названием тарифа. Используйте `/ultra/history/...` для окон до 90 дней и `/mega/history/...` — до 365 дней (только Ultra и Mega). См. раздел [Уровни путей для исторических данных ADS-B](#historical-adsb-path-tiers) ниже.

<a id="per-second-limits" />

## Посекундные ограничения частоты запросов [#per-second-rate-limits]

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

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

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

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

<a id="quota-headers" />

## Заголовки квоты [#quota-headers]

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

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

<ForProvider only="direct">
  **Эти заголовки сообщают о защитном пороге от злоупотреблений, а не о вашей месячной квоте по тарифу.** Этот порог — жёсткий суточный лимит, установленный значительно выше обычного уровня использования; он нужен, чтобы ограничить ущерб от скомпрометированного или вышедшего из-под контроля ключа. Не используйте эти заголовки для расчёта оставшейся оплаченной квоты или суммы счёта — проверяйте использование относительно вашего тарифа в [клиентском портале Polar](https://polar.sh/skylink-api/portal/).

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

<ForProvider only="rapidapi">
  На маркетплейсе эти заголовки напрямую отражают вашу месячную квоту по тарифу. Проверяйте `X-RateLimit-Requests-Remaining` перед пакетными заданиями, чтобы избежать неожиданных ошибок `429` во время их выполнения.
</ForProvider>

## 429 — превышен лимит запросов [#429--rate-limit-exceeded]

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

```json
{ "message": "Too many requests" }
```

Это происходит, когда вы исчерпали месячную квоту или превысили [посекундное ограничение частоты запросов](#per-second-limits) вашего тарифа. Используйте экспоненциальную задержку (backoff) и повторите запрос. Полную таблицу повторных попыток и вспомогательную функцию на Python см. в разделе [Обработка ошибок → Правила повторных попыток](/docs/errors#retry-rules).

***

<a id="historical-adsb-path-tiers" />

## Уровни путей для исторических данных ADS-B [#historical-ads-b-path-tiers]

Эндпоинты исторических данных [ADS-B](https://www.faa.gov/air_traffic/technology/adsb) используют **префиксы 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](/docs/v31/historical-adsb#error-responses).

Подробности об эндпоинтах и примеры интеграции см. в разделе [Исторические данные ADS-B](/docs/v31/historical-adsb).