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

PDF123 поддържа път за качване и изтегляне без акаунт. Същите операции са и под /api/v1/, така че скрипт може да ги извиква, без човек да натиска Process. Анонимната употреба не изисква API ключ. Ограниченията на честотата не позволяват тази повърхност да се превърне в неограничен безплатен хостинг.

Анонимното е пътят по подразбиране

Пуснете файл на страница с инструмент като Compress или Merge и го изпълнете. Анонимният 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 след всяко извикване и да намалявате темпото, когато се приближи до нула.

Защо един безплатен инструмент все пак ограничава извикващите

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

Таваните защитават и споделения процесор за операции, които наистина са скъпи: големи сливания, OCR, който връща Markdown от сканирания (text/markdown, а не PDF с нов слой), и многостъпкови изпълнения на POST /api/v1/pipeline. Продуктовият избор е „анонимно и ограничено“, а не „анонимно и неограничено“.

Анонимният достъп все още е временна обработка: качванията се обработват за задачата и се изчистват, когато резултатът е готов. Ограничаването на честотата е за справедливо разпределение на капацитета, а не за създаване на дългосрочно хранилище за документи зад безплатна стена за вход.

Ключовете променят самоличността, не каталога

Създайте ключ от Developers, когато ви трябва стабилна самоличност на извикващия, повторни опити с Idempotency-Key, които не бива да изпълнят работата два пъти, или самостоятелно хостван сървър с фиксиран глобален ключ (SECURITY_CUSTOMGLOBALAPIKEY на вашата машина). OpenAPI остава на /v1/openapi.json на който и базов адрес да използвате.

MCP на /mcp следва същия каталог и същата история с ключове за клиентите за автоматизация. Операциите остават същите, независимо дали извикващият е анонимен, или използва ключ. Променят се автентикацията и квотата.

За четирите начина за достъп до една операция (браузър, curl, MCP, CLI) вижте Една и съща операция, четири клиента. За преместване на цялата повърхност във вашата мрежа, когато таваните или съхранението не стигат, вижте Какво всъщност ви дава самостоятелното хостване.