OpenAPI Specification — CleverUtils API

Télécharger la spécification

La spécification OpenAPI 3.1 se trouve à :

URL

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

Vous pouvez la télécharger directement avec cURL :

cURL

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

Générer un SDK client

Utilisez openapi-generator pour créer un client typé dans n'importe quel langage. Exemples :

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

Importer dans Postman / Insomnia

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

Swagger UI interactif

Explorez et testez les points de terminaison directement dans votre navigateur :

Swagger UI est chargé à la demande. Cliquez sur le bouton ci-dessous pour afficher l'explorateur d'API interactif. Nous ne le chargeons pas automatiquement afin de garder cette page légère.

Couverture de la spécification

La spécification OpenAPI décrit :

POST /api/v1/convert — convertisseur de fichiers universel (143+ paires de formats)
POST /api/v1/batch — point de terminaison par lots multi-fichiers (jusqu'à 20 fichiers)
GET /api/v1/jobs/{job_id} — consultation du statut des tâches
GET /api/v1/jobs/{job_id}/output — télécharger le fichier converti
GET /api/v1/batches/{batch_id} — statut agrégé des lots
POST /api/v1/tools/{slug} — outils spécialisés (IA, édition, PDF) — 45+ slugs
GET /api/v1/health — sonde de santé du service
GET /api/v1/limits — utilisation actuelle des limites de débit

Versionnement

La spécification est versionnée en même temps que l'API. Les changements non rétrocompatibles seront publiés dans un nouveau /api/v2/openapi.json avec au moins 6 mois de préavis. Les changements rétrocompatibles (nouveaux points de terminaison, nouveaux champs optionnels) sont intégrés à v1 immédiatement.

Voir aussi :

Démarrage rapide en 60 secondes — une conversion de fichier fonctionnelle en 8 langages
Référence des points de terminaison — documentation lisible
Limites de débit — quotas et en-têtes

Spécification OpenAPI