Лимиты запросов

Sofia API считает запросы в трёх окнах: 15 минут, 24 часа и 30 дней.

Токен	15 минут	24 часа	30 дней
Личный ключ (на аккаунт)	150	1 000	10 000
OAuth-клиент	100	500	15 000
OAuth-клиент, на каждого авторизованного человека (до 1 000)	+10	+25	+100

Заголовки

Каждый ответ сообщает, сколько осталось, в формате IETF:

http

RateLimit: "15m";r=144;t=43, "24h";r=994;t=13543, "30d";r=9994;t=13543
RateLimit-Policy: "15m";q=150;w=900, "24h";q=1000;w=86400, "30d";q=10000;w=2592000

r: число оставшихся запросов; t: секунды до сброса окна; q: квота; w: окно в секундах.

Когда окно заполнено

Вы получите 429 rate_limit_exceeded с заголовком Retry-After и исчерпанным окном в details. Подождите указанное время, прежде чем повторять.

Эффективное использование API

Зарегистрируйте webhook вместо того, чтобы опрашивать публикацию.
Используйте limit до 100, чтобы читать списки меньшим числом страниц.
Кэшируйте то, что меняется редко: платформы, заведения, подключённые аккаунты.