OpenAPI Specification — CleverUtils API

Descargar la especificación

La especificación OpenAPI 3.1 se encuentra en:

URL

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

Puedes descargarla directamente con cURL:

cURL

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

Generar un SDK de cliente

Usa openapi-generator para crear un cliente tipado en cualquier lenguaje. Ejemplos:

Cliente Python

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

Cliente TypeScript

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

Cliente Go

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

Importar en Postman / Insomnia

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

Swagger UI interactivo

Explora y prueba los endpoints directamente en tu navegador:

Swagger UI se carga bajo demanda. Haz clic en el botón de abajo para mostrar el explorador de API interactivo. No lo cargamos automáticamente para mantener esta página ligera.

Cobertura de la especificación

La especificación OpenAPI describe:

POST /api/v1/convert — convertidor universal de archivos (143+ pares de formatos)
POST /api/v1/batch — endpoint de lote multiarchivo (hasta 20 archivos)
GET /api/v1/jobs/{job_id} — consulta del estado del trabajo
GET /api/v1/jobs/{job_id}/output — descargar el archivo convertido
GET /api/v1/batches/{batch_id} — estado agregado del lote
POST /api/v1/tools/{slug} — herramientas especializadas (IA, edición, PDF) — 45+ slugs
GET /api/v1/health — sonda de salud del servicio
GET /api/v1/limits — uso actual de los límites de tasa

Versionado

La especificación se versiona junto con la API. Los cambios incompatibles irán en un nuevo /api/v2/openapi.json con al menos 6 meses de aviso. Los cambios retrocompatibles (nuevos endpoints, nuevos campos opcionales) se incorporan a v1 de inmediato.

Véase también:

Inicio rápido en 60 segundos — una conversión de archivo funcional en 8 lenguajes
Referencia de endpoints — documentación legible
Límites de tasa — cuotas y cabeceras

Especificación OpenAPI