API PDF di Macaaw
API PDF per comprimere, convertire e firmare
Un’unica API REST per 22 strumenti PDF e firme elettroniche. Ogni attività viene eseguita sui nostri server a Londra e i file vengono eliminati entro 2 ore.
Ottieni una chiave sandbox gratuitaLeggi la documentazione dell’API
- OpenAPI 3.1
- Collezione Postman
- Sandbox gratuita
- Webhook firmati
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"}- 22Strumenti PDF su un unico endpoint
- 1 chiamataper caricare e avviare un’attività
- < 2 hfino all’eliminazione dei tuoi file
- 0 £per la sandbox
Cosa puoi realizzare
Le attività sui PDF di cui il tuo prodotto non dovrebbe occuparsi
Riduci i caricamenti prima di archiviarli
Comprimi i PDF, o adattali a una dimensione esatta, nel momento in cui i tuoi utenti li caricano.
Converti file Office in PDF
Da Word, Excel, PowerPoint, OpenDocument e HTML a PDF, con layout che restano intatti.
Rendi ricercabili le scansioni
Riconoscimento del testo in 32 lingue, PDF/A per gli archivi e tabelle direttamente in Excel.
Invia accordi dalla tua app
Crea un documento da un PDF, posiziona i campi con tag di testo, invialo e scarica la copia firmata.
Incorpora la firma nel tuo prodotto
Apri una sessione di firma all’interno del tuo sito, limitata alle origini che consenti.
Esegui lotti con i webhook
Avvia centinaia di attività e ricevi un callback firmato al termine di ciascuna.
Chiavi con ambiti e batch
Chiavi con ambiti e rotazione, attività in batch, avanzamento in tempo reale e anteprime delle pagine.
Editor integrati
Inserisci l’editor PDF o l’editor di immagini nella tua app, accanto alla firma integrata.
Come funziona
Dalla chiave al risultato in quattro chiamate
Crea una chiave
Crea una chiave sandbox nel tuo account. Passa a una chiave di produzione quando è tutto pronto.
Account › SviluppatoriAvvia un’attività
Invia i file e lo strumento in un’unica richiesta multipart.
POST /public/v1/tasksRicevi l’avviso al termine
Iscriviti a task_completed oppure interroga l’attività.
webhook: task_completedScarica
Recupera il risultato, poi eliminalo o lascialo scadere.
GET /tasks/{id}/download
Endpoint
Un’API piccola e prevedibile
URL di base https://macaaw.com/public/v1 · JSON con chiavi snake_case · Authorization: API-Key …
Attività · strumenti PDF
- GET
/toolsOgni strumento che puoi chiamare, con le relative opzioni - POST
/tasksCarica i file e avvia uno strumento in una sola chiamata - GET
/tasks/{id}Stato: queued, processing, completed o failed - GET
/tasks/{id}/downloadIl file di risultato, oppure uno ZIP - DELETE
/tasks/{id}Elimina subito i file
Documenti · firme elettroniche
- POST
/documentsUn PDF con destinatari e campi, oppure tag di testo - POST
/documents/{id}/sendInvia via email, oppure in modo silenzioso per la firma incorporata - GET
/documents/{id}/detailsDestinatari, campi e la cronologia completa - POST
/documents/{id}/sessionUn link di firma per la tua pagina - GET
/documents/{id}/downloadIl PDF firmato con il relativo certificato
Webhook
- POST
/webhook-subscriptionsScegli trigger come task_completed o document_state_changed - GET
/webhook-eventsCronologia delle consegne, con reinvio
Sicurezza
Pronta per la produzione dal primo giorno
Le stesse regole di eliminazione e l’elaborazione nel Regno Unito del sito web, più i controlli che un team di sviluppo si aspetta.
- Chiavi sotto il tuo controlloChiavi di produzione e sandbox, mostrate una sola volta e archiviate come hash. Revoca qualsiasi chiave dal tuo account.
- Webhook firmatiOgni consegna include ?signature= con un HMAC-SHA256 del corpo, creato con la tua chiave condivisa.
- File eliminati rapidamenteI file delle attività vengono conservati 1 ora con un account gratuito e 2 ore con Pro e Business, poi spariscono. DELETE li rimuove subito.
- Elaborazione nel Regno UnitoOgni attività viene eseguita sui nostri server a Londra. I log delle richieste non memorizzano mai il contenuto o i nomi dei file.
- Limiti di frequenza equi120 nuove attività al minuto per utente, con Retry-After su ogni 429.
- Tentativi ripetuti sicuriInvia una Idempotency-Key e una richiesta ripetuta restituisce il primo risultato per 24 ore.
Prezzi
Inizia gratis. Paga man mano che cresci.
Sandbox
0 £
- Ogni endpoint, con dati di prova
- 10 richieste al minuto
- Fino a 5 pagine per attività
- Output con timbro “Sandbox”
- Dati di prova eliminati dopo 7 giorni
Produzione, con Pro o Business
Da 4,99 £al mese, con fatturazione annuale
- Usa le quote mensili del tuo piano
- Poi crediti: da 5 £ per 500
- 1 credito per pagina OCR, 2 crediti per conversione Office
- 120 nuove attività al minuto
Enterprise
Prezzi a volume
- Prezzi a volume su pagine e conversioni
- Limiti personalizzati, venduti con contratto
- Fatturazione annuale
- Un referente dedicato
Domande
Le domande degli sviluppatori
C’è un modo gratuito per provare l’API?
Sì. Qualsiasi utente registrato può creare gratis una chiave sandbox. Le chiamate sandbox sono limitate a 10 al minuto e 5 pagine per attività, ogni output riporta il timbro “Sandbox” e i dati di prova vengono eliminati dopo 7 giorni.
Quali strumenti posso chiamare?
I 22 strumenti che funzionano sui nostri server, da Comprimi e OCR alle conversioni Office e PDF/A, più le firme elettroniche. GET /tools li elenca con le relative opzioni. I 33 strumenti nel browser funzionano nei browser dei tuoi utenti, quindi non sono nell’API v1.
Come viene addebitato l’uso dell’API?
Le chiavi di produzione sono incluse in Pro e Business. Le chiamate usano le stesse quote mensili del sito web; oltre queste si applicano i crediti. I pacchetti di crediti partono da 5 £ per 500 crediti e durano 12 mesi.
Avete degli SDK?
La documentazione include esempi da copiare e incollare in curl, Node e Python per ogni endpoint, un file OpenAPI 3.1 e una collezione Postman, così puoi generare un client in qualsiasi linguaggio.
Cosa succede se il mio endpoint webhook non è raggiungibile?
Riproviamo altre tre volte, dopo 1 minuto, 10 minuti e 1 ora, poi segnaliamo la consegna come non riuscita. Puoi inviarla di nuovo dal tuo account o con l’API.
Rilascia funzionalità PDF questa settimana.
Crea una chiave sandbox in un minuto. Nessuna carta richiesta.