Entwickler-API

Die Azpy-API ermöglicht es Ihnen, Dateien programmatisch über eine einfache, vorhersehbare HTTP-Schnittstelle zu konvertieren. Sie nutzt dieselbe Engine wie die Website, sodass sich eine im Browser getestete Konvertierung über die API identisch verhält.

Endpunkte

POST

/api/v1/convert/:slug

Konvertiert eine hochgeladene Datei. :slug ist die Konvertierungs-ID, z. B. docx-to-pdf.

GET

/api/v1/convert/:slug

Prüft, ob eine Server-Konvertierung verfügbar ist, und ihre aktuellen Grenzen.

GET

/api/v1/tools

Listet alle unterstützten Konvertierungen mit Verarbeitungsmodus und akzeptierten Formaten.

Beispiel, DOCX in PDF konvertieren

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

Antwort

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

[PDF-Bytes]

Authentifizierung

Anfragen werden mit einem API-Schlüssel als Bearer-Token authentifiziert. Schlüssel werden im Business-Plan ausgegeben. Ohne Schlüssel sind nicht authentifizierte Anfragen eingeschränkt und pro IP limitiert.

Grenzen

Business-API-Schlüssel haben je nach Plan höhere Dateigrößen- und Nutzungslimits. Laufende Konvertierungen sind temporär und werden nie gespeichert; Dateien werden unmittelbar nach der Konvertierung gelöscht.