Byggd för AI-agenter, inte bara webbläsare: så fungerar API:t

En webbläsarflik fungerar fortfarande: välj ett verktyg, ladda upp en fil, ladda ner resultatet. Agenter och skript anropar samma operationer utan att öppna något gränssnitt. Båda vägarna träffar samma katalog.

Varje verktygssida är också en slutpunkt

Slå ihop PDF, dela, komprimera, OCR, konvertera: varje verktyg i katalogen motsvarar en väg under /api/v1/…. Öppna en verktygssida och rulla ner till Anropa från kod för ett curl-exempel som är byggt från verktygets riktiga parametrar, inte från en generisk mall. Anonyma anrop kräver varken konto eller API-nyckel på den publika webbplatsen; de anonyma prefixen är /api/v1/general/, /api/v1/misc/, /api/v1/security/, /api/v1/convert/ och /api/v1/filter/.

Så här ser merge-exemplet ut:

curl -fsS -X POST "$API_BASE/api/v1/general/merge-pdfs" \
  -F "[email protected]" \
  -F "[email protected]" \
  -o merged.pdf

OpenAPI ligger på /v1/openapi.json. Arbetsflöden i flera steg använder POST /api/v1/pipeline med en ordnad steps-lista. Skicka Idempotency-Key när ett nytt försök inte får köra ett förändrande jobb två gånger. Svar från den hostade tjänsten annonserar X-RateLimit-Limit, X-RateLimit-Remaining och X-RateLimit-Reset; vid HTTP 429 läser du Retry-After (anonym hastighetsbegränsning).

OCR genom samma katalog returnerar Markdown (text/markdown) från /api/v1/misc/ocr-pdf, inte en PDF med ett dolt textlager. Agenter som förväntar sig en sökbar PDF från den slutpunkten hanterar nedladdningen fel; kontraktet är textextrahering för pipelines, inte en omskrivning i OCRmyPDF-stil.

MCP för klienter som talar det

MCP (Model Context Protocol) låter agentklienter upptäcka och anropa verktyg som funktioner i stället för att skrapa dokumentation. Den här webbplatsen exponerar en MCP-server på /mcp vid sidan av REST-API:t, så att en kompatibel klient ansluter en gång och får hela katalogen.

MCP och REST delar samma förväntningar på autentisering: anonymt där verktygsprefixen tillåter det, API-nycklar för stabil automation och för självhostade servrar med åtkomstspärr. Att rikta en agent mot /mcp är inte en annan produkt än att rikta curl mot /api/v1/…. Dokumentation: MCP för utvecklare.

Fel är strukturerade, inte löptext

Misslyckade anrop returnerar application/problem+json i RFC 7807-stil, inte ett naket 500 eller ”något gick fel”. Varje svarskropp har en stabil kod (rate_limited, bad_request, invalid_document, missing_dependency med flera), en läsbar ledtråd och ofta ett nästa steg. Människor kan skumma den; agenter kan avgöra om de ska göra ett nytt försök, byta ut filen eller avbryta, utan att någon behöver tolka en stackspårning.

Den strukturen betyder mer än en vänlig HTML-felsida när anroparen är ett skript. Referens: Fel i utvecklar-API:t.

llms.txt är till för verktyg, inte för rankning

/llms.txt är ett klartextindex över alla verktyg (namn, kortbeskrivning, URL), genererat från samma katalog som driver webbplatsen. Kodagenter och dokumentationsverktyg kan läsa det som en README. Det är ingen spak för Google-rankning: Sök ignorerar /llms.txt (källor: Googles guide för AI-optimering). Eftersom filen genereras kan den inte tyst bli inaktuell på det sätt en handredigerad fil kan.

CLI och agentfärdighet delar samma former

pdfx kan köra pdf-core lokalt eller --cloud mot en bas-URL. Skillen för kodagenter under dist/skills/pdf-toolbox/SKILL.md dokumenterar curl-formerna för merge och pipeline, så att agenter inte hittar på ett andra kontrakt. Fyra klienter, en katalog: Samma operation, fyra klienter.

Webbläsarvägen är oförändrad

Att släppa en fil i en flik fungerar som förut. Den extra ytan är samma slutpunkter för en agent, ett skript eller CI: samma bearbetning, ingen människa emellan. Egen drift behåller den ytan i ditt nätverk (Kör själv); den hostade tjänsten förblir den anonyma testvägen.

API-referens: Swagger. Grunder för båda vägarna: Hjälp och Utvecklare.