PDF API

Macaaw PDF API

PDF API voor comprimeren, converteren en ondertekenen

Eén REST API voor 22 PDF-tools en e-handtekeningen. Elke taak wordt uitgevoerd op onze servers in Londen en de bestanden worden binnen 2 uur verwijderd.

Gratis sandboxsleutel aanvragenLees de API-documentatie

  • OpenAPI 3.1
  • Postman-collectie
  • Gratis sandbox
  • Ondertekende webhooks
Een PDF comprimeren met één verzoek
Taal van het codevoorbeeld
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-tools op één endpoint
  • 1 aanroepom te uploaden en een taak te starten
  • < 2 htot je bestanden worden verwijderd
  • £ 0voor de sandbox

Wat je kunt bouwen

Het PDF-werk dat je product niet zelf hoeft te doen

  • Verklein uploads voordat je ze opslaat

    Comprimeer PDF's, of pas ze aan een exacte grootte aan, zodra je gebruikers ze uploaden.

  • Office-bestanden naar PDF converteren

    Word, Excel, PowerPoint, OpenDocument en HTML naar PDF, met opmaak die blijft staan.

  • Maak scans doorzoekbaar

    Tekstherkenning in 32 talen, PDF/A voor archieven en tabellen direct naar Excel.

  • Verstuur overeenkomsten vanuit je eigen app

    Maak een document van een PDF, plaats velden met teksttags, verstuur het en download de ondertekende kopie.

  • Ondertekenen insluiten in je product

    Open een ondertekeningssessie op je eigen site, beperkt tot de origins die je toestaat.

  • Batches uitvoeren met webhooks

    Start honderden taken en krijg een ondertekende callback zodra elke taak klaar is.

  • Sleutels met bereik en batches

    Sleutels met bereik en rotatie, batchtaken, live voortgang en paginaweergaven.

  • Ingebedde editors

    Zet de pdf-editor of de afbeeldingseditor in uw eigen app, naast ingebed ondertekenen.

Zo werkt het

Van sleutel tot resultaat in vier aanroepen

  1. Maak een sleutel

    Maak een sandboxsleutel in je account. Stap over op een live sleutel als je er klaar voor bent.

    Account › Ontwikkelaar
  2. Start een taak

    Stuur de bestanden en de tool in één multipart-verzoek.

    POST /public/v1/tasks
  3. Hoor wanneer het klaar is

    Abonneer je op task_completed, of vraag de taak periodiek op.

    webhook: task_completed
  4. Downloaden

    Haal het resultaat op en verwijder het, of laat het verlopen.

    GET /tasks/{id}/download

Endpoints

Een kleine, voorspelbare API

Basis-URL https://macaaw.com/public/v1 · JSON met snake_case-sleutels · Authorization: API-Key …

Volledige API-referentie

Taken · PDF-tools

  • GET/toolsElke tool die je kunt aanroepen, met de opties
  • POST/tasksUpload bestanden en start een tool in één aanroep
  • GET/tasks/{id}Status: queued, processing, completed of failed
  • GET/tasks/{id}/downloadHet resultaatbestand, of een ZIP
  • DELETE/tasks/{id}Verwijder de bestanden nu

Documenten · e-handtekeningen

  • POST/documentsEen PDF plus ontvangers en velden, of teksttags
  • POST/documents/{id}/sendVersturen per e-mail, of stil voor ingesloten ondertekening
  • GET/documents/{id}/detailsOntvangers, velden en de volledige tijdlijn
  • POST/documents/{id}/sessionEen ondertekeningslink voor je eigen pagina
  • GET/documents/{id}/downloadDe ondertekende PDF met het certificaat

Webhooks

  • POST/webhook-subscriptionsKies triggers zoals task_completed of document_state_changed
  • GET/webhook-eventsBezorggeschiedenis, met opnieuw versturen

Beveiliging

Vanaf dag één gebouwd voor productie

Dezelfde verwijderregels en verwerking in het Verenigd Koninkrijk als de website, plus de instellingen die een engineeringteam verwacht.

  • Sleutels die jij beheertLive- en sandboxsleutels, één keer getoond en opgeslagen als hash. Trek elke sleutel in vanuit je account.
  • Ondertekende webhooksElke bezorging bevat ?signature= met een HMAC-SHA256 van de inhoud, gemaakt met je gedeelde sleutel.
  • Bestanden snel verwijderdTaakbestanden worden 1 uur bewaard bij een gratis account en 2 uur bij Pro en Business, daarna zijn ze weg. DELETE verwijdert ze meteen.
  • Verwerking in het Verenigd KoninkrijkElke taak wordt uitgevoerd op onze servers in Londen. Aanvraaglogs bewaren nooit bestandsinhoud of bestandsnamen.
  • Eerlijke aanvraaglimieten120 nieuwe taken per minuut per gebruiker, met Retry-After bij elke 429.
  • Veilig opnieuw proberenStuur een Idempotency-Key mee en een herhaald verzoek geeft 24 uur lang het eerste resultaat terug.

Prijzen

Begin gratis. Betaal naarmate je groeit.

Sandbox

£ 0

  • Elk endpoint, met testgegevens
  • 10 verzoeken per minuut
  • Maximaal 5 pagina's per taak
  • Uitvoer met de stempel “Sandbox”
  • Testgegevens verwijderd na 7 dagen
Sandboxsleutel aanvragen

Live, bij Pro of Business

Vanaf £ 4,99per maand, jaarlijks gefactureerd

  • Gebruikt de maandtegoeden van je abonnement
  • Daarna credits: vanaf £ 5 voor 500
  • 1 credit per OCR-pagina, 2 credits per Office-conversie
  • 120 nieuwe taken per minuut
Abonnementen vergelijken

Enterprise

Volumeprijzen

  • Volumeprijzen voor pagina's en conversies
  • Aangepaste limieten, verkocht via een contract
  • Jaarlijkse facturering op factuur
  • Een vaste contactpersoon
Neem contact op

Vragen

Ontwikkelaars vragen

Kan ik de API gratis uitproberen?

Ja. Elke ingelogde gebruiker kan gratis een sandboxsleutel maken. Sandboxaanroepen zijn beperkt tot 10 per minuut en 5 pagina's per taak, elke uitvoer krijgt de stempel “Sandbox”, en testgegevens worden na 7 dagen verwijderd.

Welke tools kan ik aanroepen?

De 22 tools die op onze servers werken, van Comprimeren en OCR tot Office-conversies en PDF/A, plus e-handtekeningen. GET /tools geeft ze met hun opties. De 33 browsertools werken in de browsers van je gebruikers en zitten daarom niet in API v1.

Hoe wordt API-gebruik in rekening gebracht?

Live sleutels horen bij Pro en Business. Aanroepen gebruiken dezelfde maandtegoeden als de website; daarboven gelden credits. Creditpakketten beginnen bij £ 5 voor 500 credits en blijven 12 maanden geldig.

Hebben jullie SDK's?

De documentatie bevat voorbeelden om te kopiëren en plakken in curl, Node en Python voor elk endpoint, een OpenAPI 3.1-bestand en een Postman-collectie, zodat je een client in elke taal kunt genereren.

Wat gebeurt er als mijn webhook-endpoint onbereikbaar is?

We proberen het nog drie keer, na 1 minuut, 10 minuten en 1 uur, en markeren de bezorging daarna als mislukt. Je kunt hem opnieuw versturen vanuit je account of met de API.

Lever deze week PDF-functies op.

Maak in een minuut een sandboxsleutel. Geen kaart nodig.