OpenAPI Specification — CleverUtils API

Spezifikation herunterladen

Die OpenAPI 3.1-Spezifikation befindet sich unter:

URL

https://cleverutils.com/api/v1/openapi.json

Sie können sie direkt mit cURL herunterladen:

cURL

curl -O https://cleverutils.com/api/v1/openapi.json

Client-SDK generieren

Verwenden Sie openapi-generator, um einen typisierten Client in einer beliebigen Sprache zu erstellen. Beispiele:

Python-Client

openapi-generator-cli generate \
  -i https://cleverutils.com/api/v1/openapi.json \
  -g python \
  -o ./cleverutils-python-client

TypeScript-Client

openapi-generator-cli generate \
  -i https://cleverutils.com/api/v1/openapi.json \
  -g typescript-fetch \
  -o ./cleverutils-ts-client

Go-Client

openapi-generator-cli generate \
  -i https://cleverutils.com/api/v1/openapi.json \
  -g go \
  -o ./cleverutils-go-client

In Postman / Insomnia importieren

Postman: File → Import → Link, fügen Sie https://cleverutils.com/api/v1/openapi.json ein
Insomnia: Import → From URL, gleiche URL
Bruno: Collection → Import → OpenAPI v3 Spec

Interaktive Swagger UI

Durchsuchen und testen Sie Endpunkte direkt in Ihrem Browser:

Swagger UI wird bei Bedarf geladen. Klicken Sie auf die Schaltfläche unten, um den interaktiven API-Explorer anzuzeigen. Wir laden ihn nicht automatisch, um diese Seite leichtgewichtig zu halten.

Umfang der Spezifikation

Die OpenAPI-Spezifikation beschreibt:

POST /api/v1/convert — universeller Dateikonverter (143+ Formatpaare)
POST /api/v1/batch — Mehrfach-Datei-Batch-Endpunkt (bis zu 20 Dateien)
GET /api/v1/jobs/{job_id} — Abfrage des Job-Status
GET /api/v1/jobs/{job_id}/output — konvertierte Datei herunterladen
GET /api/v1/batches/{batch_id} — aggregierter Batch-Status
POST /api/v1/tools/{slug} — spezialisierte Tools (KI, Bearbeitung, PDF) — 45+ Slugs
GET /api/v1/health — Service-Health-Probe
GET /api/v1/limits — aktuelle Rate-Limit-Nutzung

Versionierung

Die Spezifikation wird zusammen mit der API versioniert. Breaking Changes erscheinen in einem neuen /api/v2/openapi.json mit mindestens 6 Monaten Vorlaufzeit. Abwärtskompatible Änderungen (neue Endpunkte, neue optionale Felder) werden sofort in v1 übernommen.

Siehe auch:

60-Sekunden-Schnellstart — eine funktionierende Dateikonvertierung in 8 Sprachen
Endpunkt-Referenz — menschenlesbare Dokumentation
Rate Limits — Kontingente und Header

OpenAPI-Spezifikation