Un appel, un fichier, un résultat
L'API de conversion tient en deux endpoints : une conversion, et la table des paires servies. Gratuit, sans clé et sans compte — protégé par une limite de rafale.
Essayer tout de suite
Envoyez n'importe quel fichier jusqu'à 10 Mo en multipart HTTP, avec la cible dans `to` :
curl -X POST https://api.convertchester.com/v1/convert \ -F "file=@logo.png" \ -F "to=jpeg"
Structure de la réponse JSON
Un refus structurel renvoie HTTP 200 OK avec status: "refused" et un motif : le verdict est dans le corps. Les erreurs HTTP 4xx ne concernent que la requête elle-même — fichier vide, trop gros, cible inconnue.
{
"status": "converted",
"document": {
"sha256": "30f35a4b89f071a82f57ed9834fd77df...",
"bytes": 80
},
"source": "png",
"target": "jpeg",
"result": {
"filename": "logo.jpg",
"media_type": "image/jpeg",
"sha256": "6a7570d4efd75f9f3d9780e044240c88...",
"bytes": 644,
"content": "/9j/4AAQSkZJRgABAgAAAQAB…"
}
}Endpoints disponibles
| Méthode | Chemin | Rôle |
|---|---|---|
| POST | /v1/convert | Convertir un fichier vers le format demandé |
| GET | /v1/formats | La table des paires servies — calculée, jamais rédigée |
| GET | /v1/usage | L'usage du compte courant (clé requise) |
| GET | /v1/openapi | La spécification OpenAPI, servie par l’API elle-même |
En-têtes utiles
Accept-Language choisit la langue des messages lisibles (fr ou en) — les codes, eux, ne se traduisent jamais. Idempotency-Key lie une clé à l'empreinte du fichier soumis : la rejouer avec le même fichier est sans conséquence, la rejouer avec un autre rend 409 idempotency_conflict.
Ce qui se décompte
Avec une clé d'API, l'unité comptée est le fichier distinct, identifié par son SHA-256 — pas l'appel HTTP. Re-soumettre le même fichier est gratuit pendant sept jours, et un refus n'est jamais décompté : on ne décompte que ce qu'on a produit.