API développeur

L'API Azpy vous permet de convertir des fichiers par programmation via une interface HTTP simple et prévisible. Elle partage le même moteur que le site, donc la conversion que vous testez dans le navigateur se comporte de manière identique via l'API.

Points de terminaison

POST

/api/v1/convert/:slug

Convertit un fichier téléversé. Le :slug est l'id de conversion, ex. docx-to-pdf.

GET

/api/v1/convert/:slug

Vérifie si une conversion serveur est disponible et ses limites actuelles.

GET

/api/v1/tools

Liste toutes les conversions prises en charge avec leur mode de traitement et leurs formats acceptés.

Exemple, convertir DOCX en PDF

curl -X POST https://azpy.es/api/v1/convert/docx-to-pdf \
  -H "Authorization: Bearer VOTRE_CLÉ_API" \
  -F "file=@report.docx" \
  --output report.pdf

Réponse

200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="report.pdf"

[octets PDF]

Authentification

Les requêtes sont authentifiées avec une clé API envoyée comme jeton Bearer. Les clés sont délivrées avec le plan Business. Sans clé, les requêtes non authentifiées sont limitées et soumises à un quota par IP.

Limites

Les clés API Business bénéficient de limites de taille de fichier et de quotas d'utilisation supérieurs selon le plan. Les conversions en cours sont temporaires et jamais stockées ; les fichiers sont supprimés immédiatement après la conversion.