API per sviluppatori

L'API di Azpy ti permette di convertire file a livello di programmazione con un'interfaccia HTTP semplice e prevedibile. Condivide lo stesso motore del sito, quindi la conversione che provi nel browser si comporta in modo identico tramite l'API.

Endpoint

POST

/api/v1/convert/:slug

Converte un file caricato. :slug è l'id di conversione, es. docx-to-pdf.

GET

/api/v1/convert/:slug

Verifica se una conversione server è disponibile e i suoi limiti attuali.

GET

/api/v1/tools

Elenca tutte le conversioni supportate con modalità di elaborazione e formati accettati.

Esempio, convertire DOCX in PDF

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

Risposta

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

[byte del PDF]

Autenticazione

Le richieste sono autenticate con una chiave API inviata come token Bearer. Le chiavi vengono rilasciate nel piano Business. Senza chiave, le richieste non autenticate sono limitate e soggette a limiti di velocità per IP.

Limiti

Le chiavi API Business beneficiano di limiti di dimensione dei file e quote di utilizzo superiori in base al piano. Le conversioni in corso sono temporanee e mai memorizzate; i file vengono eliminati immediatamente dopo la conversione.