Macaaw PDF API
PDF API för att komprimera, konvertera och signera
Ett REST API för 22 PDF-verktyg och e-underskrifter. Varje uppgift körs på våra servrar i London och filerna raderas inom 2 timmar.
Skaffa en gratis sandlådenyckelLäs API-dokumentationen
- OpenAPI 3.1
- Postman-samling
- Gratis sandlåda
- Signerade webhooks
curl https://macaaw.com/public/v1/tasks \
-H "Authorization: API-Key $MACAAW_API_KEY" \
-F "files[]=@lease.pdf" \
-F 'data={"tool":"compress-pdf","options":{"level":"recommended"}}'
# 201 Created
{ "id": "…", "tool": "compress-pdf", "status": "task.queued" }// Node 18+ (fetch, FormData and Blob are built in)
import { readFile } from "node:fs/promises";
const form = new FormData();
form.append("files[]", new Blob([await readFile("lease.pdf")]), "lease.pdf");
form.append("data", JSON.stringify({ tool: "compress-pdf", options: { level: "recommended" } }));
const res = await fetch("https://macaaw.com/public/v1/tasks", {
method: "POST",
headers: { Authorization: `API-Key ${process.env.MACAAW_API_KEY}` },
body: form,
});
const task = await res.json(); // { id, tool, status: "task.queued" }# Python 3 with requests
import json, os, requests
res = requests.post(
"https://macaaw.com/public/v1/tasks",
headers={"Authorization": f"API-Key {os.environ['MACAAW_API_KEY']}"},
files={"files[]": open("lease.pdf", "rb")},
data={"data": json.dumps({"tool": "compress-pdf", "options": {"level": "recommended"}})},
)
task = res.json() # {"id": ..., "status": "task.queued"}- 22PDF-verktyg på en slutpunkt
- 1 anropför att ladda upp och starta en uppgift
- < 2 htills dina filer raderas
- 0 GBPför sandlådan
Det här kan du bygga
PDF-jobben som din produkt inte borde behöva äga
Krymp uppladdningar innan du lagrar dem
Komprimera PDF-filer, eller anpassa dem till en exakt storlek, i samma stund som dina användare laddar upp dem.
Konvertera Office-filer till PDF
Word, Excel, PowerPoint, OpenDocument och HTML till PDF, med layouter som håller.
Gör skanningar sökbara
Textigenkänning på 32 språk, PDF/A för arkiv och tabeller direkt till Excel.
Skicka avtal från din egen app
Skapa ett dokument från en PDF, placera fält med texttaggar, skicka det och ladda ned den signerade kopian.
Bädda in signering i din produkt
Öppna en signeringssession på din webbplats, begränsad till de ursprung du tillåter.
Kör batcher med webhooks
Starta hundratals uppgifter och få ett signerat återanrop när var och en är klar.
Nycklar med behörigheter och batcher
Nycklar med behörigheter och rotation, batchuppgifter, förlopp i realtid och sidbilder.
Inbäddade redigerare
Bygg in PDF-redigeraren eller bildredigeraren i din egen app, bredvid inbäddad signering.
Så fungerar det
Från nyckel till resultat i fyra anrop
Skapa en nyckel
Skapa en sandlådenyckel i ditt konto. Byt till en live-nyckel när du är redo.
Konto › UtvecklareStarta en uppgift
Skicka filerna och verktyget i en multipart-förfrågan.
POST /public/v1/tasksFå veta när den är klar
Prenumerera på task_completed, eller fråga efter uppgiftens status.
webhook: task_completedLadda ned
Hämta resultatet och radera det sedan eller låt det gå ut.
GET /tasks/{id}/download
Slutpunkter
Ett litet, förutsägbart API
Bas-URL https://macaaw.com/public/v1 · JSON med nycklar i snake_case · Authorization: API-Key …
Uppgifter · PDF-verktyg
- GET
/toolsAlla verktyg du kan anropa, med deras alternativ - POST
/tasksLadda upp filer och starta ett verktyg i ett anrop - GET
/tasks/{id}Status: queued, processing, completed eller failed - GET
/tasks/{id}/downloadResultatfilen, eller en ZIP - DELETE
/tasks/{id}Radera filerna nu
Dokument · e-underskrifter
- POST
/documentsEn PDF plus mottagare och fält, eller texttaggar - POST
/documents/{id}/sendSkicka via e-post, eller tyst för inbäddad signering - GET
/documents/{id}/detailsMottagare, fält och hela tidslinjen - POST
/documents/{id}/sessionEn signeringslänk för din egen sida - GET
/documents/{id}/downloadDen signerade PDF-filen med dess intyg
Webhooks
- POST
/webhook-subscriptionsVälj utlösare som task_completed eller document_state_changed - GET
/webhook-eventsLeveranshistorik, med omsändning
Säkerhet
Byggt för produktion från första dagen
Samma raderingsregler och bearbetning i Storbritannien som webbplatsen, plus de kontroller ett utvecklingsteam förväntar sig.
- Nycklar som du kontrollerarLive- och sandlådenycklar, som visas en gång och lagras som hash. Återkalla vilken nyckel som helst från ditt konto.
- Signerade webhooksVarje leverans har ?signature= med en HMAC-SHA256 av innehållet, gjord med din delade nyckel.
- Filer raderas snabbtUppgiftsfiler sparas i 1 timme på ett gratiskonto och 2 timmar på Pro och Business, sedan är de borta. DELETE tar bort dem direkt.
- Bearbetning i StorbritannienVarje uppgift körs på våra servrar i London. Förfrågningsloggarna sparar aldrig filinnehåll eller filnamn.
- Rimliga hastighetsgränser120 nya uppgifter per minut och användare, med Retry-After på varje 429.
- Säkra omförsökSkicka en Idempotency-Key så returnerar en upprepad förfrågan det första resultatet i 24 timmar.
Priser
Börja gratis. Betala när du växer.
Sandlåda
0 GBP
- Alla slutpunkter, med testdata
- 10 förfrågningar per minut
- Upp till 5 sidor per uppgift
- Resultat stämplade med ”Sandbox”
- Testdata raderas efter 7 dagar
Live, på Pro eller Business
Från 4,99 GBPi månaden, faktureras årsvis
- Använder din plans månadskvoter
- Därefter krediter: från 5 GBP för 500
- 1 kredit per OCR-sida, 2 krediter per Office-konvertering
- 120 nya uppgifter per minut
Enterprise
Volympriser
- Volympriser på sidor och konverteringar
- Anpassade gränser, enligt avtal
- Årlig fakturering
- En namngiven kontaktperson
Frågor
Utvecklare frågar
Finns det ett gratis sätt att prova API:t?
Ja. Alla inloggade användare kan skapa en sandlådenyckel gratis. Sandlådeanrop är begränsade till 10 per minut och 5 sidor per uppgift, varje resultat stämplas med ”Sandbox”, och testdata raderas efter 7 dagar.
Vilka verktyg kan jag anropa?
De 22 verktygen som körs på våra servrar, från Komprimera och OCR till Office-konverteringar och PDF/A, samt e-underskrifter. GET /tools listar dem med deras alternativ. De 33 webbläsarverktygen körs i dina användares webbläsare, så de finns inte i API v1.
Hur debiteras API-användning?
Live-nycklar ingår i Pro och Business. Anropen använder samma månadskvoter som webbplatsen; utöver dem används krediter. Kreditpaket börjar på 5 GBP för 500 krediter och gäller i 12 månader.
Har ni SDK:er?
Dokumentationen har exempel att kopiera och klistra in i curl, Node och Python för varje slutpunkt, en OpenAPI 3.1-fil och en Postman-samling, så att du kan generera en klient i valfritt språk.
Vad händer om min webhook-slutpunkt ligger nere?
Vi försöker tre gånger till, efter 1 minut, 10 minuter och 1 timme, och markerar sedan leveransen som misslyckad. Du kan skicka den igen från ditt konto eller med API:t.
Leverera PDF-funktioner den här veckan.
Skapa en sandlådenyckel på en minut. Inget kort behövs.