OpenAPI Specification — CleverUtils API

Baixar a especificação

A especificação OpenAPI 3.1 está em:

URL

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

Você pode baixá-la diretamente com cURL:

cURL

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

Gerar um SDK de cliente

Use o openapi-generator para criar um cliente tipado em qualquer linguagem. Exemplos:

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 no Postman / Insomnia

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

Swagger UI interativo

Navegue e teste endpoints diretamente no seu navegador:

O Swagger UI é carregado sob demanda. Clique no botão abaixo para renderizar o explorador de API interativo. Não o carregamos automaticamente para manter esta página leve.

Cobertura da especificação

A especificação OpenAPI descreve:

POST /api/v1/convert — conversor universal de arquivos (143+ pares de formatos)
POST /api/v1/batch — endpoint de lote multi-arquivo (até 20 arquivos)
GET /api/v1/jobs/{job_id} — consulta do status do job
GET /api/v1/jobs/{job_id}/output — baixar o arquivo convertido
GET /api/v1/batches/{batch_id} — status agregado do lote
POST /api/v1/tools/{slug} — ferramentas especializadas (IA, edição, PDF) — 45+ slugs
GET /api/v1/health — sonda de saúde do serviço
GET /api/v1/limits — uso atual dos limites de taxa

Versionamento

A especificação é versionada junto com a API. Mudanças incompatíveis irão para um novo /api/v2/openapi.json com pelo menos 6 meses de aviso prévio. Mudanças retrocompatíveis (novos endpoints, novos campos opcionais) entram na v1 imediatamente.

Veja também:

Início rápido em 60 segundos — uma conversão de arquivo funcional em 8 linguagens
Referência de endpoints — documentação legível
Limites de taxa — cotas e cabeçalhos

Especificação OpenAPI