Ограничения скорости и квоты

Каждый ключ API finlight привязан к тарифу, и тариф определяет ваши лимиты использования и доступные возможности. Лимиты применяются для каждого ключа API в реальном времени. На этой странице объясняется каждый лимит и что открывает каждый тариф; точные значения для вашего тарифа смотрите в панели управления finlight или на странице цен.

Четыре лимита использования

Name
Месячная квота запросов
Description
Каждый REST-запрос расходует один запрос из вашего месячного лимита. Счётчик сбрасывается в начале каждого расчётного периода. При превышении возвращается 429 с сообщением "Exceeded token limit of N for the current period."
Name
Пиковая скорость
Description
Краткосрочный лимит на число запросов за каждые 10 секунд, сглаживающий всплески. Применяется только на тарифах, где он задан. При превышении возвращается 429 с сообщением "Exceeded rate limit of N requests per 10 seconds." — подождите ~10 с и повторите.
Name
Подключения WebSocket
Description
Максимальное число одновременных подключений WebSocket для вашего ключа. Новые подключения сверх лимита отклоняются. Отдельный лимит ограничивает общее число передаваемых сообщений за период. WebSocket требует платного тарифа.
Name
Квота доставки вебхуков
Description
Максимальное число доставок вебхуков за расчётный период. Сопутствующий лимит ограничивает, сколько вебхуков вы можете создать. Когда квота доставки исчерпана, доставки приостанавливаются до следующего периода.

Возможности, открываемые вашим тарифом

Помимо самих лимитов, ваш тариф определяет, какие функции доступны. Запрос функции, не включённой в ваш тариф, возвращает 403 (для REST) или просто опускает данные (для вебхуков/WebSocket).

Name
Исторические данные
Description
Насколько далеко в прошлое вы можете запрашивать, зависит от вашего тарифа. Тарифы Free и Pro Light в настоящее время охватывают примерно последний месяц статей; более высокие тарифы открывают более глубокий исторический охват. Используйте фильтры дат from / to для запросов в пределах окна вашего тарифа — запросы для дат за его пределами просто не возвращают результатов для этого диапазона. Точное окно истории для каждого тарифа см. на странице цен.
Name
Анализ тональности
Description
Включает поля sentiment и confidence в статьях. Удаляются из полезной нагрузки, если не предоставлены.
Name
Сущности компаний
Description
Включает массив companies (тикеры, распознанные ИИ, ISIN, биржа и т. д.) и активирует includeEntities. Удаляется, если не предоставлено.
Name
Пользовательские источники
Description
Частные или специфичные для клиента источники новостей, добавленные к вашему набору по умолчанию. Доступно на более высоких / корпоративных тарифах.

Как работает применение лимитов

По ключу, в реальном времени. Каждый запрос увеличивает ваши счётчики; как только лимит превышен, API сразу возвращает 429.
Использование в панели не в реальном времени. Использование, отображаемое в панели управления finlight, агрегируется примерно раз в день и отражает активность по предыдущий день — это не счётчик в реальном времени. Применение происходит в реальном времени, поэтому ваша фактическая оставшаяся квота на сегодня может отличаться от показанной в панели.
Месячные счётчики сбрасываются в начале вашего расчётного периода — 429 по квоте очищается автоматически.
Нет заголовков ограничения скорости. finlight в настоящее время не отправляет заголовки Retry-After или X-RateLimit-*. Воспринимайте пиковый 429 как «подождите ~10 секунд»; месячный 429 — как «квота за период достигнута». См. Ошибки и коды состояния.

Тарифы

Тариф	Типичное использование
Free	Оценка и использование малого объёма. Только REST (без WebSocket).
Pro (Light / Standard / Scale)	Производственные нагрузки с растущими квотами, WebSocket, вебхуками и более богатым обогащением.
Enterprise	Большой объём, пользовательские источники и индивидуальные лимиты.

Точные числовые лимиты (месячные токены, пиковая скорость, подключения WebSocket, квота вебхуков) и набор функций по тарифам являются частью ценообразования и могут меняться. Всегда проверяйте лимиты вашего текущего тарифа в панели управления finlight или сравнивайте тарифы на странице цен. Нужны более высокие лимиты или пользовательские источники? Свяжитесь с нами.

Когда вы достигаете лимита

Пиковый 429 → приостановитесь на ~10 секунд, затем продолжайте.
429 по месячной квоте → вы израсходовали запросы периода; перейдите на более высокий тариф или дождитесь сброса.
Подключение WebSocket отклонено → вы достигли лимита одновременных подключений; закройте простаивающее подключение (см. опцию takeover в Быстром старте WebSocket).
Доставки вебхуков приостановлены → ваша квота доставки за период исчерпана; она возобновится в следующем периоде.
403 по функции → этой возможности нет в вашем тарифе; см. таблицу выше.

Точные тела ошибок см. в разделе Ошибки и коды состояния.