Développeurs

API MacedFileConvert

API REST pour automatiser conversions, compression et traitements PDF. Authentification par clé d'API ; les quotas de votre formule s'appliquent.

Gérer mes clés →Spécification OpenAPI (JSON)

1. Authentification

Créez une clé depuis votre espace compte, puis transmettez-la dans l'en-tête X-API-Key (ou Authorization: Bearer mfc_…).

curl https://api.macedfileconvert.com/v1/tools \
  -H "X-API-Key: mfc_YOUR_KEY"

2. Envoyer un fichier

POST /files (multipart, champ file) renvoie un id réutilisable.

curl https://api.macedfileconvert.com/v1/files \
  -H "X-API-Key: mfc_YOUR_KEY" \
  -F "file=@document.pdf"
# → { "id": "file_…", "originalName": "document.pdf", ... }

3. Lancer un traitement

POST /jobs avec l'identifiant d'outil, les fichiers et les paramètres. La liste des outils est exposée par GET /tools.

curl https://api.macedfileconvert.com/v1/jobs \
  -H "X-API-Key: mfc_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "compress-pdf",
    "inputFileIds": ["file_…"],
    "params": { "level": "medium" }
  }'
# → { "id": "job_…", "status": "QUEUED", ... }

4. Suivre et télécharger

Interrogez GET /jobs/:id jusqu'au statut DONE, puis récupérez l'URL signée du résultat.

curl https://api.macedfileconvert.com/v1/jobs/job_…            # { "status": "DONE", "progress": 100 }
curl https://api.macedfileconvert.com/v1/jobs/job_…/result     # { "downloadUrl": "https://…", "expiresAt": "…" }

Bon à savoir

• Les fichiers et résultats sont automatiquement purgés après expiration.
• Les quotas quotidiens dépendent de votre formule (voir Tarifs).
• Le secret d'une clé n'est affiché qu'à sa création — conservez-le précieusement.
• Révoquez une clé compromise à tout moment depuis votre compte.