API de PDF

API de PDF de Macaaw

API de PDF per comprimir, convertir i signar

Una sola API REST per a 22 eines de PDF i signatures electròniques. Cada tasca s’executa als nostres servidors de Londres i els fitxers s’eliminen en un termini de 2 hores.

Obtén una clau de proves gratuïtaLlegeix la documentació de l’API

  • OpenAPI 3.1
  • Col·lecció de Postman
  • Entorn de proves gratuït
  • Webhooks signats
Comprimeix un PDF amb una sola sol·licitud
Llenguatge de l’exemple de codi
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"}
  • 22eines de PDF en un sol endpoint
  • 1 cridaper pujar i iniciar una tasca
  • < 2 hfins que s’eliminen els teus fitxers
  • 0 £per a l’entorn de proves

Què pots crear

Les tasques amb PDF de les quals el teu producte no s’hauria d’encarregar

  • Redueix les pujades abans de guardar-les

    Comprimeix PDF, o ajusta’ls a una mida exacta, en el moment que els teus usuaris els pugen.

  • Converteix fitxers d’Office a PDF

    Word, Excel, PowerPoint, OpenDocument i HTML a PDF, amb maquetacions que es mantenen.

  • Fes cercables els escanejos

    Reconeixement de text en 32 idiomes, PDF/A per als arxius i taules directament a Excel.

  • Envia acords des de la teva pròpia aplicació

    Crea un document a partir d’un PDF, col·loca camps amb etiquetes de text, envia’l i baixa’n la còpia signada.

  • Insereix la signatura al teu producte

    Obre una sessió de signatura dins del teu lloc, limitada als orígens que permetis.

  • Executa lots amb webhooks

    Inicia centenars de tasques i rep una crida de retorn signada quan acaba cadascuna.

  • Claus amb permisos i lots

    Claus amb permisos i rotació, tasques per lots, progrés en directe i visualitzacions de pàgines.

  • Editors integrats

    Posa l’editor de PDF o l’editor d’imatges dins la teva aplicació, al costat de la signatura integrada.

Com funciona

De la clau al resultat en quatre crides

  1. Crea una clau

    Crea una clau de proves al teu compte. Passa a una clau real quan estiguis a punt.

    Compte › Desenvolupadors
  2. Inicia una tasca

    Envia els fitxers i l’eina en una sola sol·licitud multipart.

    POST /public/v1/tasks
  3. Assabenta’t de quan ha acabat

    Subscriu-te a task_completed, o consulta la tasca periòdicament.

    webhook: task_completed
  4. Baixa

    Obtén el resultat i després elimina’l o deixa que caduqui.

    GET /tasks/{id}/download

Endpoints

Una API petita i previsible

URL base https://macaaw.com/public/v1 · JSON amb claus en snake_case · Authorization: API-Key …

Referència completa de l’API

Tasques · eines de PDF

  • GET/toolsTotes les eines que pots cridar, amb les seves opcions
  • POST/tasksPuja fitxers i inicia una eina en una sola crida
  • GET/tasks/{id}Estat: queued, processing, completed o failed
  • GET/tasks/{id}/downloadEl fitxer de resultat, o un ZIP
  • DELETE/tasks/{id}Elimina els fitxers ara

Documents · signatures electròniques

  • POST/documentsUn PDF més destinataris i camps, o etiquetes de text
  • POST/documents/{id}/sendEnvia per correu, o sense avisar per a la signatura inserida
  • GET/documents/{id}/detailsDestinataris, camps i la cronologia completa
  • POST/documents/{id}/sessionUn enllaç de signatura per a la teva pròpia pàgina
  • GET/documents/{id}/downloadEl PDF signat amb el seu certificat

Webhooks

  • POST/webhook-subscriptionsTria activadors com task_completed o document_state_changed
  • GET/webhook-eventsHistorial d’entregues, amb reenviament

Seguretat

Fet per a producció des del primer dia

Les mateixes regles d’eliminació i el mateix processament al Regne Unit que el lloc web, més els controls que espera un equip d’enginyeria.

  • Claus que controles tuClaus reals i de proves, que es mostren una sola vegada i es guarden com a hash. Revoca qualsevol clau des del teu compte.
  • Webhooks signatsCada entrega porta ?signature= amb un HMAC-SHA256 del cos, fet amb la teva clau compartida.
  • Fitxers eliminats ràpidamentEls fitxers de les tasques es guarden 1 hora en un compte gratuït i 2 hores a Pro i Business, i després desapareixen. DELETE els elimina immediatament.
  • Processament al Regne UnitCada tasca s’executa als nostres servidors de Londres. Els registres de sol·licituds no guarden mai el contingut ni el nom dels fitxers.
  • Límits de freqüència raonables120 tasques noves per minut per usuari, amb Retry-After a cada 429.
  • Reintents segursEnvia una Idempotency-Key i una sol·licitud repetida retorna el primer resultat durant 24 hores.

Preus

Comença gratis. Paga a mesura que creixis.

Sandbox

0 £

  • Tots els endpoints, amb dades de prova
  • 10 sol·licituds per minut
  • Fins a 5 pàgines per tasca
  • Resultats amb el segell «Sandbox»
  • Dades de prova eliminades al cap de 7 dies
Obtén una clau de proves

Real, amb Pro o Business

Des de 4,99 £al mes, amb facturació anual

  • Fa servir les quotes mensuals del teu pla
  • Després, crèdits: des de 5 £ per 500
  • 1 crèdit per pàgina d’OCR, 2 crèdits per conversió d’Office
  • 120 tasques noves per minut
Compara els plans

Enterprise

Preus per volum

  • Preus per volum en pàgines i conversions
  • Límits personalitzats, per contracte
  • Facturació anual per factura
  • Una persona de contacte assignada
Parla amb nosaltres

Preguntes

Què pregunten els desenvolupadors

Hi ha una manera gratuïta de provar l’API?

Sí. Qualsevol usuari amb la sessió iniciada pot crear una clau de proves (sandbox) gratis. Les crides de proves estan limitades a 10 per minut i 5 pàgines per tasca, cada resultat porta el segell «Sandbox» i les dades de prova s’eliminen al cap de 7 dies.

Quines eines puc cridar?

Les 22 eines que funcionen als nostres servidors, des de Comprimir i OCR fins a les conversions d’Office i PDF/A, a més de les signatures electròniques. GET /tools les llista amb les seves opcions. Les 33 eines de navegador funcionen al navegador dels teus usuaris, així que no són a l’API v1.

Com es cobra l’ús de l’API?

Les claus reals vénen amb Pro i Business. Les crides fan servir les mateixes quotes mensuals que el lloc web; per sobre d’aquestes, s’apliquen crèdits. Els paquets de crèdits comencen a 5 £ per 500 crèdits i duren 12 mesos.

Teniu SDK?

La documentació té exemples per copiar i enganxar en curl, Node i Python per a cada endpoint, un fitxer OpenAPI 3.1 i una col·lecció de Postman, perquè puguis generar un client en qualsevol llenguatge.

Què passa si el meu endpoint de webhook ha caigut?

Ho tornem a provar tres vegades més, al cap d’1 minut, 10 minuts i 1 hora, i després marquem l’entrega com a fallida. La pots tornar a enviar des del teu compte o amb l’API.

Llança funcions de PDF aquesta setmana.

Crea una clau de proves en un minut. No cal targeta.