Ontwikkelaars-API

Met de Azpy-API kunt u bestanden programmatisch converteren via een eenvoudige, voorspelbare HTTP-interface. Deze deelt dezelfde engine als de website, dus een conversie die u in de browser test, gedraagt zich via de API identiek.

Endpoints

POST

/api/v1/convert/:slug

Converteert een geüpload bestand. De :slug is de conversie-id, bijv. docx-to-pdf.

GET

/api/v1/convert/:slug

Controleert of een serverconversie beschikbaar is en wat de huidige limieten zijn.

GET

/api/v1/tools

Lijst alle ondersteunde conversies met hun verwerkingsmodus en geaccepteerde formaten.

Voorbeeld, DOCX naar PDF converteren

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

Antwoord

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

[PDF-bytes]

Authenticatie

Verzoeken worden geverifieerd met een API-sleutel die als Bearer-token wordt verzonden. API-sleutels worden verstrekt in het Business-plan. Zonder sleutel zijn niet-geauthenticeerde verzoeken beperkt en worden ze per IP beperkt.

Limieten

Business-API-sleutels hebben afhankelijk van het plan hogere limieten voor bestandsgrootte en gebruik. Lopende conversies zijn tijdelijk en worden nooit opgeslagen; bestanden worden direct na de conversie verwijderd.