Sense registrar-se: com la limitació de taxa anònima manté gratis una eina gratuïta

PDF123 manté un camí de càrrega i descàrrega sense compte. Les mateixes operacions també són sota /api/v1/ perquè un script les pugui cridar sense que cap persona faci clic a Processa. L'ús anònim no necessita cap clau d'API. Els límits de taxa impedeixen que aquesta superfície es converteixi en un amfitrió gratuït il·limitat.

L'anònim és el camí per defecte

Deixeu un fitxer en una pàgina d'eina com Comprimeix o Uneix i executeu-la. El REST anònim sota /api/v1/ funciona igual per a les eines del catàleg. Els punts de destinació sota /api/v1/general/, /api/v1/misc/, /api/v1/security/, /api/v1/convert/ i /api/v1/filter/ són els prefixos anònims; cada eina del catàleg del portal es correspon amb aquests camins.

Iniciar sessió existeix perquè pugueu crear una clau d'API personal per a l'automatització, no perquè Processa es converteixi en un mur de pagament. El formulari del navegador i el contracte HTTP es mantenen alineats: el bloc «Crida-ho des del codi» de cada pàgina construeix un curl amb els mateixos camps que envia el formulari.

Les rutes d'administració, de perfil d'usuari i altres rutes que no són d'eines queden fora d'aquests prefixos. Qui crida anònimament una ruta restringida rep un error d'autenticació, no una passada gratuïta per tota la superfície de l'API.

Què diuen les capçaleres

Cada resposta de l'API allotjada anuncia el pressupost (implementat a pdfx-server):

• X-RateLimit-Limit: el límit del període anunciat per a aquesta resposta
• X-RateLimit-Remaining: el pressupost que queda en el període actual
• X-RateLimit-Reset: el marcador de reinici de la finestra (llegiu-ne el valor; no doneu per fet que sigui un dia natural)

En un HTTP 429, Retry-After indica a un client educat quan pot tornar-ho a provar. Els errors de quota fan servir el codi estructurat rate_limited de Errors per a desenvolupadors, amb la mateixa forma application/problem+json que altres errors de l'API. Un script pot bifurcar-se pel codi sense haver d'interpretar una pàgina HTML d'error.

Els límits numèrics només canvien segons la configuració del desplegament. Les capçaleres d'una resposta concreta són la font de veritat, no una captura d'aquest article. Un client que fixi en dur un nombre diari tret d'aquí s'equivocarà el proper cop que un operador ajusti el període. És millor llegir X-RateLimit-Remaining després de cada crida i reduir el ritme quan s'acosti a zero.

Per què una eina gratuïta encara limita qui la crida

Sense límits, els punts de destinació anònims es converteixen en la granja de lots d'algú altre. Els límits mantenen utilitzables les tasques puntuals mentre les càrregues més pesades o privades passen a les claus o a l'autoallotjament.

Els límits també protegeixen la CPU compartida per a les operacions realment cares: unions grans, OCR que retorna Markdown d'escanejos (text/markdown, no un PDF amb una capa nova) i execucions de POST /api/v1/pipeline de diversos passos. L'elecció de producte és «anònim i finit», no «anònim i il·limitat».

L'accés anònim continua sent processament temporal: les càrregues es gestionen per a la tasca i es netegen quan el resultat està a punt. La limitació de taxa té a veure amb l'equitat de la capacitat, no amb inventar un magatzem de documents a llarg termini darrere un mur d'inici de sessió gratuït.

Les claus canvien la identitat, no el catàleg

Creeu una clau des de Desenvolupadors quan necessiteu una identitat estable de qui crida, reintents amb Idempotency-Key que no hagin de duplicar la feina, o un servidor autoallotjat amb una clau global fixa (SECURITY_CUSTOMGLOBALAPIKEY a la vostra màquina). L'OpenAPI continua a /v1/openapi.json a qualsevol URL base que ataqueu.

L'MCP a /mcp segueix el mateix catàleg i la mateixa història de claus per als clients d'automatització. Les operacions continuen sent les mateixes tant si qui crida és anònim com si té clau. El que canvia és l'autenticació i la quota.

Per als quatre camins cap a una mateixa operació (navegador, curl, MCP i CLI), vegeu La mateixa operació, quatre clients. Per traslladar tota la superfície a la vostra xarxa quan els límits o la retenció no us bastin, vegeu Què us aporta realment l'autoallotjament.