API PDF

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
Comprimi un PDF con una sola richiesta
Linguaggio dell’esempio di codice
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

  1. Crea una chiave

    Crea una chiave sandbox nel tuo account. Passa a una chiave di produzione quando è tutto pronto.

    Account › Sviluppatori
  2. Avvia un’attività

    Invia i file e lo strumento in un’unica richiesta multipart.

    POST /public/v1/tasks
  3. Ricevi l’avviso al termine

    Iscriviti a task_completed oppure interroga l’attività.

    webhook: task_completed
  4. Scarica

    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 …

Riferimento API completo

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
Ottieni una chiave sandbox

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
Confronta i piani

Enterprise

Prezzi a volume

  • Prezzi a volume su pagine e conversioni
  • Limiti personalizzati, venduti con contratto
  • Fatturazione annuale
  • Un referente dedicato
Parla con noi

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.