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

Каждый аккаунт может выполнить 30 вызовов создания ссылок за окно в 60 секунд, общее для REST POST /api/v1/links, POST /api/v1/uploads, POST /api/v1/sheets и MCP create_links. Обычный запрос и отправка пакета расходуют по одному вызову независимо от числа входных значений. Каждое резервирование загрузки и отправка таблицы расходуют один вызов; дочерние преобразования ссылок не расходуют дополнительных вызовов.

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

RateLimit-Policy: "create-links";q=30;w=60
RateLimit: "create-links";r=29;t=60

q — квота, w — её окно в секундах. r — оставшиеся вызовы; t — секунды до освобождения места. Это структурированные поля, а не просто числа.

При исчерпании квоты возвращается 429 с проблемой rate-limited и Retry-After в секундах. Подождите перед повтором и согласуйте работу клиентов одного аккаунта. Чтение заданий не расходует эту квоту; следуйте их указаниям poll_after_seconds и Retry-After.

Окно поискаКопировать ссылку на раздел

Поиск по ключевым словам имеет собственное окно 30 вызовов на аккаунт за 60 секунд. Допуск поиска не расходует вызовы создания ссылок. Распознанные ссылки на товары, продавцов, таблицы и неподдерживаемые ссылки пропускают поиск по ключевым словам и не расходуют ни одну из двух квот; непрочитанные ссылки могут перейти к такому поиску.

Успешные ответы после проверки допуска к поиску по ключевым словам и отказы из-за лимита содержат:

RateLimit-Policy: "search";q=30;w=60
RateLimit: "search";r=29;t=60

Отклонённый поиск возвращает 429 с search-rate-limited и Retry-After. Поля заголовков имеют те же значения, что выше. Воспроизведение с Idempotency-Key не расходует новый вызов создания ссылок; 429 не сохраняется для воспроизведения.