Ingen inloggning krävs: så håller anonym hastighetsbegränsning ett gratis verktyg gratis

PDF123 har en väg för uppladdning och nedladdning som inte kräver något konto. Samma operationer finns också under /api/v1/, så att ett skript kan anropa dem utan att någon klickar på en knapp. Anonym användning kräver ingen API-nyckel. Hastighetsgränserna ser till att den ytan inte blir en obegränsad gratisvärd.

Anonymt är standardvägen

Släpp in en fil på en verktygssida som Komprimera PDF eller Slå ihop PDF och kör. Anonym REST under /api/v1/ fungerar på samma sätt för katalogverktygen. Slutpunkterna under /api/v1/general/, /api/v1/misc/, /api/v1/security/, /api/v1/convert/ och /api/v1/filter/ är prefixen för de anonyma verktygen; varje katalogverktyg i portalen hör till någon av de vägarna.

Inloggningen finns för att du ska kunna skapa en personlig API-nyckel för automatisering, inte för att göra körningen till en betalvägg. Formuläret i webbläsaren och HTTP-kontraktet hålls i linje: varje verktygssidas block ”Anropa från kod” bygger ett curl-kommando från samma fält som formuläret skickar.

Admin-, profil- och andra vägar utanför verktygskatalogen ligger utanför de prefixen. En anonym anropare som träffar en spärrad väg får ett autentiseringsfel, inte fri tillgång till hela API-ytan.

Vad svarshuvudena säger

Varje svar från den hostade tjänsten annonserar sin budget (implementerat i pdfx-server):

• X-RateLimit-Limit: annonserat tak för perioden i det här svaret
• X-RateLimit-Remaining: återstående budget i den aktuella perioden
• X-RateLimit-Reset: markör för när fönstret nollställs (läs värdet; utgå inte från ett kalenderdygn)

Vid HTTP 429 talar Retry-After om för en artig klient när den kan försöka igen. Kvotfel använder den strukturerade problemkoden rate_limited enligt Fel i utvecklar-API:t, med samma form application/problem+json som andra API-fel. Ett skript kan förgrena sig på koden utan att skrapa en HTML-felsida.

Numeriska tak ändras bara med driftsättningens inställningar. Huvudena i ett givet svar är sanningen, inte en ögonblicksbild i en bloggtext. En klient som hårdkodar ett dygnstal från den här artikeln har fel nästa gång en operatör ställer om perioden. Läs hellre X-RateLimit-Remaining efter varje anrop och trappa ner när värdet närmar sig noll.

Varför ett gratis verktyg ändå begränsar anropare

Utan tak blir de anonyma slutpunkterna någon annans batchfabrik. Gränserna håller engångsjobb användbara medan tyngre eller privata arbetsbelastningar flyttar till nycklar eller egen drift.

Taken skyddar också delad processorkraft för operationer som verkligen är dyra: stora sammanslagningar, OCR som returnerar Markdown från skanningar (text/markdown, inte en PDF med pålagrat textlager) och flerstegskörningar via POST /api/v1/pipeline. Produktvalet är ”anonymt och ändligt”, inte ”anonymt och obegränsat”.

Anonym åtkomst är fortfarande tillfällig bearbetning: uppladdningar hanteras för jobbet och rensas när resultatet är klart. Hastighetsbegränsningen handlar om rättvis fördelning av kapacitet, inte om att bygga ett långsiktigt dokumentarkiv bakom en gratis inloggning.

Nycklar ändrar identiteten, inte katalogen

Skapa en nyckel på Utvecklare när du behöver en stabil identitet som anropare, återförsök med Idempotency-Key som inte får köra samma arbete två gånger, eller en egen server med en fast global nyckel (SECURITY_CUSTOMGLOBALAPIKEY på din maskin). OpenAPI ligger kvar på /v1/openapi.json oavsett vilken basadress du använder.

MCP på /mcp följer samma katalog och samma nyckelmodell för automatiserade klienter. Operationerna är desamma oavsett om anroparen är anonym eller använder en nyckel. Det är autentisering och kvot som skiljer.

För de fyra sätten att nå samma operation (webbläsare, curl, MCP och kommandoradsverktyget), se Samma operation, fyra klienter. För att flytta hela ytan till ditt eget nätverk när tak eller bevarandekrav inte räcker, se Vad du faktiskt vinner på att köra själv.