API PDF Macaaw
API PDF pour compresser, convertir et signer
Une seule API REST pour 20 outils PDF et les signatures électroniques. Chaque tâche s’exécute sur nos serveurs à Londres et les fichiers sont supprimés sous 2 heures.
Obtenir une clé sandbox gratuiteLire la documentation de l’API
- OpenAPI 3.1
- Collection Postman
- Sandbox gratuite
- Webhooks signés
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"}- 20outils PDF sur un seul endpoint
- 1 appelpour importer et lancer une tâche
- < 2 havant la suppression de vos fichiers
- 0 £GBpour la sandbox
Ce que vous pouvez créer
Les tâches PDF que votre produit ne devrait pas avoir à gérer
Allégez les fichiers importés avant de les stocker
Compressez des PDF, ou ajustez-les à une taille exacte, dès que vos utilisateurs les importent.
Convertissez des fichiers Office en PDF
Word, Excel, PowerPoint, OpenDocument et HTML en PDF, avec une mise en page fidèle.
Rendez les numérisations consultables
Reconnaissance de texte dans 27 langues, PDF/A pour l’archivage, et tableaux directement vers Excel.
Envoyez des accords depuis votre propre application
Créez un document à partir d’un PDF, placez des champs avec des balises de texte, envoyez-le et téléchargez l’exemplaire signé.
Intégrez la signature dans votre produit
Ouvrez une session de signature directement sur votre site, limitée aux origines que vous autorisez.
Traitez des lots avec des webhooks
Lancez des centaines de tâches et recevez un rappel signé à la fin de chacune.
Comment ça marche
De la clé au résultat en quatre appels
Créer une clé
Créez une clé sandbox dans votre compte. Passez à une clé de production quand vous êtes prêt.
Compte › DéveloppeurLancer une tâche
Envoyez les fichiers et l’outil dans une seule requête multipart.
POST /public/v1/tasksSoyez prévenu à la fin
Abonnez-vous à task_completed, ou interrogez la tâche.
webhook : task_completedTélécharger
Récupérez le résultat, puis supprimez-le ou laissez-le expirer.
GET /tasks/{id}/download
Endpoints
Une API simple et prévisible
URL de base https://macaaw.com/public/v1 · JSON avec des clés en snake_case · Authorization: API-Key …
Tâches · outils PDF
- GET
/toolsTous les outils que vous pouvez appeler, avec leurs options - POST
/tasksImportez des fichiers et lancez un outil en un seul appel - GET
/tasks/{id}Statut : en file d’attente, en cours, terminé ou échoué - GET
/tasks/{id}/downloadLe fichier résultat, ou un ZIP - DELETE
/tasks/{id}Supprimer les fichiers maintenant
Documents · signatures électroniques
- POST
/documentsUn PDF, plus les destinataires et les champs, ou des balises de texte - POST
/documents/{id}/sendEnvoi par e-mail, ou en mode silencieux pour la signature intégrée - GET
/documents/{id}/detailsDestinataires, champs et historique complet - POST
/documents/{id}/sessionUn lien de signature pour votre propre page - GET
/documents/{id}/downloadLe PDF signé avec son certificat
Webhooks
- POST
/webhook-subscriptionsChoisissez des déclencheurs comme task_completed ou document_state_changed - GET
/webhook-eventsHistorique des envois, avec renvoi
Sécurité
Conçue pour la production dès le premier jour
Les mêmes règles de suppression et le même traitement au Royaume-Uni que sur le site, plus les contrôles qu’attend une équipe d’ingénierie.
- Des clés que vous contrôlezClés de production et sandbox, affichées une seule fois et stockées sous forme de hachage. Révoquez n’importe quelle clé depuis votre compte.
- Webhooks signésChaque envoi comporte ?signature= avec un HMAC-SHA256 du corps, calculé avec votre clé partagée.
- Fichiers supprimés rapidementLes fichiers des tâches sont conservés 1 heure avec un compte gratuit et 2 heures avec Pro et Business, puis ils disparaissent. DELETE les supprime immédiatement.
- Traitement au Royaume-UniChaque tâche s’exécute sur nos serveurs à Londres. Les journaux de requêtes ne stockent jamais le contenu ni les noms des fichiers.
- Limites de débit équitables120 nouvelles tâches par minute et par utilisateur, avec Retry-After sur chaque 429.
- Réessais sans risqueEnvoyez une Idempotency-Key et une requête répétée renvoie le premier résultat pendant 24 heures.
Tarifs
Commencez gratuitement. Payez à mesure que vous grandissez.
Sandbox
0 £GB
- Tous les endpoints, avec des données de test
- 10 requêtes par minute
- Jusqu’à 5 pages par tâche
- Résultats estampillés « Sandbox »
- Données de test supprimées après 7 jours
Production, avec Pro ou Business
À partir de 4,99 £GBpar mois, facturé annuellement
- Utilise les quotas mensuels de votre formule
- Ensuite, des crédits : à partir de 5 £GB pour 500
- 1 crédit par page OCR, 2 crédits par conversion Office
- 120 nouvelles tâches par minute
Enterprise
Tarifs dégressifs
- Tarifs dégressifs sur les pages et les conversions
- Limites personnalisées, vendues sous contrat
- Facturation annuelle sur facture
- Un contact dédié
Questions
Les questions des développeurs
Existe-t-il un moyen gratuit d’essayer l’API ?
Oui. Tout utilisateur connecté peut créer gratuitement une clé sandbox. Les appels sandbox sont limités à 10 par minute et à 5 pages par tâche, chaque résultat est estampillé « Sandbox », et les données de test sont supprimées après 7 jours.
Quels outils puis-je appeler ?
Les 20 outils qui s’exécutent sur nos serveurs, de Compresser et OCR aux conversions Office et PDF/A, ainsi que les signatures électroniques. GET /tools les liste avec leurs options. Les 20 outils du navigateur s’exécutent dans le navigateur de vos utilisateurs ; ils ne figurent donc pas dans l’API v1.
Comment l’utilisation de l’API est-elle facturée ?
Les clés de production sont incluses avec Pro et Business. Les appels utilisent les mêmes quotas mensuels que le site ; au-delà, des crédits s’appliquent. Les packs de crédits commencent à 5 £GB pour 500 crédits et sont valables 12 mois.
Proposez-vous des SDK ?
La documentation propose des exemples à copier-coller en curl, Node et Python pour chaque endpoint, un fichier OpenAPI 3.1 et une collection Postman, pour que vous puissiez générer un client dans n’importe quel langage.
Que se passe-t-il si mon endpoint de webhook est indisponible ?
Nous réessayons trois fois de plus, après 1 minute, 10 minutes et 1 heure, puis nous marquons l’envoi comme échoué. Vous pouvez le renvoyer depuis votre compte ou avec l’API.
Lancez vos fonctions PDF cette semaine.
Créez une clé sandbox en une minute. Sans carte bancaire.