API per a desenvolupadors

L'API de Azpy et permet convertir fitxers programàticament amb una interfície HTTP senzilla i previsible. Comparteix el mateix motor que el lloc web, així que la conversió que proves al navegador es comporta igual a través de l'API.

Endpoints

POST

/api/v1/convert/:slug

Converteix un fitxer pujat. El :slug és l'id de conversió, p. ex. docx-to-pdf.

GET

/api/v1/convert/:slug

Comprova si una conversió de servidor està disponible i els seus límits actuals.

GET

/api/v1/tools

Llista totes les conversions compatibles amb el seu mode de processament i formats acceptats.

Exemple: convertir DOCX a PDF

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

Resposta

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

[bytes del PDF]

Autenticació

Les peticions s'autentiquen amb una clau API enviada com a token Bearer. Les claus s'emeten al pla Business. Sense clau, les peticions no autenticades tenen límits i estan subjectes a límit de velocitat per IP.

Límits

Les claus API de Business tenen límits de mida de fitxer i quotes d'ús superiors segons el pla. Les conversions en curs són temporals i mai no s'emmagatzemen; els fitxers s'eliminen immediatament després de la conversió.