Без входа в аккаунт: как анонимное ограничение частоты сохраняет бесплатный инструмент бесплатным

PDF123 сохраняет путь «загрузил и скачал» без аккаунта. Те же операции лежат и под /api/v1/, чтобы скрипт мог вызвать их без человека, нажимающего кнопку Process. Анонимное использование не требует API-ключа. Ограничения частоты не дают этой поверхности превратиться в безлимитный бесплатный хостинг.

Анонимность — путь по умолчанию

Перетащите файл на страницу инструмента вроде Сжатия или Слияния и запустите его. Анонимный REST под /api/v1/ работает так же для инструментов каталога. Эндпоинты под /api/v1/general/, /api/v1/misc/, /api/v1/security/, /api/v1/convert/ и /api/v1/filter/ — это префиксы анонимных инструментов; каждый инструмент каталога в портале отображается в эти пути.

Вход в аккаунт существует, чтобы вы могли создать личный API-ключ для автоматизации, а не чтобы кнопка Process стала платной стеной. Форма в браузере и HTTP-контракт остаются согласованными: блок «Call this from code» на каждой странице инструмента собирает curl из тех же полей, которые отправляет форма.

Маршруты администратора, профиля пользователя и прочие неинструментальные находятся вне этих префиксов. Анонимный вызывающий, попавший на закрытый путь, получает ошибку аутентификации, а не бесплатный проход по всей поверхности API.

Что говорят заголовки

Каждый ответ хостингового API сообщает бюджет (реализовано в pdfx-server):

• X-RateLimit-Limit: заявленный лимит периода для этого ответа
• X-RateLimit-Remaining: остаток бюджета в текущем периоде
• X-RateLimit-Reset: маркер сброса для окна (читайте значение; не предполагайте календарный день)

При HTTP 429 заголовок Retry-After говорит вежливому клиенту, когда попробовать снова. Отказы по квоте используют структурированный код проблемы rate_limited в разделе Ошибки для разработчиков, с той же формой application/problem+json, что и другие сбои API. Скрипт может ветвиться по коду, не разбирая HTML-страницу ошибки.

Числовые лимиты могут меняться с настройками развёртывания. Источник истины — заголовки конкретного ответа, а не снимок в блоге. Клиент, жёстко зашивший дневное число из этой статьи, ошибётся в следующий раз, когда эксплуатация перенастроит период. Предпочитайте читать X-RateLimit-Remaining после каждого вызова и снижать темп, когда он приближается к нулю.

Зачем бесплатному инструменту ограничивать вызывающих

Без лимитов анонимные эндпоинты становятся чужой пакетной фермой. Ограничения сохраняют разовые задачи рабочими, а более тяжёлые или приватные нагрузки переводят на ключи или собственный хостинг.

Лимиты также защищают общий CPU для операций, которые действительно дороги: большие слияния, OCR, возвращающий Markdown из сканов (text/markdown, а не PDF с заново наложенным слоем), и многошаговые запуски POST /api/v1/pipeline. Продуктовый выбор — «анонимно и конечно», а не «анонимно и безлимитно».

Анонимный доступ — всё равно временная обработка: загрузки обрабатываются для задачи и удаляются, когда результат готов. Ограничение частоты — про справедливость распределения мощностей, а не про изобретение долговременного хранилища документов за бесплатной стеной входа.

Ключи меняют идентичность, а не каталог

Создайте ключ в разделе Разработчикам, когда нужна стабильная идентичность вызывающего, повторные попытки с Idempotency-Key, которые не должны запускать работу дважды, или собственный сервер с фиксированным глобальным ключом (SECURITY_CUSTOMGLOBALAPIKEY на вашей машине). OpenAPI остаётся на /v1/openapi.json на том базовом URL, к которому вы обращаетесь.

MCP на /mcp следует тому же каталогу и той же истории с ключами для клиентов автоматизации. Операции остаются теми же, анонимный вызывающий или с ключом. Меняются аутентификация и квота.

О четырёх способах обратиться к одной операции (браузер, curl, MCP, CLI) см. Одна операция, четыре клиента. О переносе всей поверхности в вашу сеть, когда лимитов или хранения не хватает, см. Что на самом деле даёт самостоятельный хостинг.