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
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
Maak een sleutel
Maak een sandboxsleutel in je account. Stap over op een live sleutel als je er klaar voor bent.
Account › OntwikkelaarStart een taak
Stuur de bestanden en de tool in één multipart-verzoek.
POST /public/v1/tasksHoor wanneer het klaar is
Abonneer je op task_completed, of vraag de taak periodiek op.
webhook: task_completedDownloaden
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 …
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
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
Enterprise
Volumeprijzen
- Volumeprijzen voor pagina's en conversies
- Aangepaste limieten, verkocht via een contract
- Jaarlijkse facturering op factuur
- Een vaste contactpersoon
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.