PDF API

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
Komprimera en PDF med en förfrågan
Språk för kodexempel
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

  1. Skapa en nyckel

    Skapa en sandlådenyckel i ditt konto. Byt till en live-nyckel när du är redo.

    Konto › Utvecklare
  2. Starta en uppgift

    Skicka filerna och verktyget i en multipart-förfrågan.

    POST /public/v1/tasks
  3. Få veta när den är klar

    Prenumerera på task_completed, eller fråga efter uppgiftens status.

    webhook: task_completed
  4. Ladda 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 …

Fullständig API-referens

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
Skaffa en sandlådenyckel

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
Jämför planer

Enterprise

Volympriser

  • Volympriser på sidor och konverteringar
  • Anpassade gränser, enligt avtal
  • Årlig fakturering
  • En namngiven kontaktperson
Prata med oss

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.