OpenAPI Specification — CleverUtils API

Download de specificatie

De OpenAPI 3.1-specificatie staat op:

URL

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

Je kunt deze direct downloaden met cURL:

cURL

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

Een client-SDK genereren

Gebruik openapi-generator om een getypeerde client in elke taal op te zetten. Voorbeelden:

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

Importeren in Postman / Insomnia

Postman: File → Import → Link, plak https://cleverutils.com/api/v1/openapi.json
Insomnia: Import → From URL, dezelfde URL
Bruno: Collection → Import → OpenAPI v3 Spec

Interactieve Swagger UI

Blader door en test endpoints direct in je browser:

Swagger UI wordt op aanvraag geladen. Klik op de knop hieronder om de interactieve API-verkenner te tonen. We laden deze niet automatisch om deze pagina lichtgewicht te houden.

Specificatie-dekking

De OpenAPI-specificatie beschrijft:

POST /api/v1/convert — universele bestandsconverter (143+ formaatparen)
POST /api/v1/batch — multi-bestand batch-endpoint (tot 20 bestanden)
GET /api/v1/jobs/{job_id} — opvragen van taakstatus
GET /api/v1/jobs/{job_id}/output — geconverteerd bestand downloaden
GET /api/v1/batches/{batch_id} — geaggregeerde batchstatus
POST /api/v1/tools/{slug} — gespecialiseerde tools (AI, bewerken, PDF) — 45+ slugs
GET /api/v1/health — service health-probe
GET /api/v1/limits — huidig gebruik van rate limits

Versiebeheer

De specificatie heeft dezelfde versie als de API. Breaking changes komen in een nieuwe /api/v2/openapi.json met minstens 6 maanden aankondiging vooraf. Achterwaarts compatibele wijzigingen (nieuwe endpoints, nieuwe optionele velden) worden direct in v1 opgenomen.

Zie ook:

Snelstart in 60 seconden — een werkende bestandsconversie in 8 talen
Endpoint-referentie — leesbare documentatie
Rate limits — quota en headers

OpenAPI-specificatie