API Développeurs

Accès programmatique aux conversions serveur Converty.

L'API v1 utilise le même pipeline de conversion que l'application web. Vous avez besoin d'une clé API pour votre projet.

Authentification

Envoyez votre clé API à chaque requête :

Authorization: Bearer YOUR_API_KEY
# or
X-API-Key: YOUR_API_KEY

Points de terminaison

URL de base : https://api.example.com

GET /v1 — Métadonnées API (aucune clé requise)
POST /v1/convert/document — PDF, Word, Excel, …
POST /v1/convert/audio — audio · video · image · archive · ebook · 3d
GET /progress/:jobId — Flux Server-Sent Events
GET /download/:jobId?token=… — Téléchargement signé
POST /import/url — Récupérer un fichier distant (corps JSON { "url": "…" })

Catégories: document · audio · video · image · archive · ebook · 3d

Flux typique

POST formulaire multipart vers /v1/convert/{category} avec file, from, to et options JSON.
Recevez { jobId, estimatedSeconds }.
Abonnez-vous à GET /progress/{jobId} (SSE) pour le statut en direct.
Téléchargez depuis l'URL signée dans l'événement complete.

curl -X POST "https://api.example.com/v1/convert/document" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@document.pdf" \
  -F "from=pdf" \
  -F "to=docx" \
  -F 'options={}'

Limites

Des limites de débit standard s'appliquent par IP. Les fichiers doivent correspondre à des paires de formats prises en charge. Voir le registre des convertisseurs pour les valeurs from/to valides.

Besoin de limites plus élevées ou d'une clé dédiée ? Contactez-nous.