Без входу: як анонімне обмеження швидкості зберігає інструмент безкоштовним

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

Анонімність — типовий шлях

Киньте файл на сторінку інструменту, наприклад Стиснути чи Об’єднати, і запустіть його. Анонімний REST під /api/v1/ працює так само для інструментів каталогу. Кінцеві точки під /api/v1/general/, /api/v1/misc/, /api/v1/security/, /api/v1/convert/ і /api/v1/filter/ — це анонімні префікси інструментів; кожен інструмент каталогу в порталі відображається на ці шляхи.

Вхід існує, щоб ви могли створити особистий ключ API для автоматизації, а не щоб «Обробити» стало платним бар’єром. Форма в браузері та HTTP-контракт лишаються узгодженими: блок із прикладом виклику з коду на кожній сторінці інструменту будує 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 за будь-якої базової адреси, до якої ви звертаєтеся.

MCP на /mcp дотримується того самого каталогу й тієї самої історії ключів для клієнтів автоматизації. Операції лишаються тими самими, незалежно від того, анонімний клієнт чи з ключем. Змінюються автентифікація й квота.

Про чотири способи звернутися до однієї операції (браузер, curl, MCP, CLI) див. Та сама операція, чотири клієнти. Про перенесення всієї поверхні у вашу мережу, коли меж і зберігання не досить, див. Що насправді дає власний хостинг.