OpenAPI Specification — CleverUtils API

Scarica la specifica

La specifica OpenAPI 3.1 si trova su:

URL

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

Puoi scaricarla direttamente con cURL:

cURL

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

Genera un SDK client

Usa openapi-generator per creare un client tipizzato in qualsiasi linguaggio. Esempi:

Client Python

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

Client TypeScript

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

Client Go

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

Importa in Postman / Insomnia

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

Swagger UI interattivo

Sfoglia e prova gli endpoint direttamente nel tuo browser:

Swagger UI viene caricato su richiesta. Fai clic sul pulsante qui sotto per visualizzare l'esploratore API interattivo. Non lo carichiamo automaticamente per mantenere leggera questa pagina.

Copertura della specifica

La specifica OpenAPI descrive:

POST /api/v1/convert — convertitore di file universale (143+ coppie di formati)
POST /api/v1/batch — endpoint batch multi-file (fino a 20 file)
GET /api/v1/jobs/{job_id} — polling dello stato del job
GET /api/v1/jobs/{job_id}/output — scarica il file convertito
GET /api/v1/batches/{batch_id} — stato aggregato del batch
POST /api/v1/tools/{slug} — strumenti specializzati (IA, modifica, PDF) — 45+ slug
GET /api/v1/health — sonda di integrità del servizio
GET /api/v1/limits — utilizzo corrente dei rate limit

Versioning

La specifica viene versionata insieme all'API. I breaking change andranno in un nuovo /api/v2/openapi.json con almeno 6 mesi di preavviso. I cambiamenti retrocompatibili (nuovi endpoint, nuovi campi opzionali) entrano in v1 immediatamente.

Vedi anche:

Avvio rapido in 60 secondi — una conversione di file funzionante in 8 linguaggi
Riferimento degli endpoint — documentazione leggibile
Rate limit — quote e header

Specifica OpenAPI