ConverterHQDevelopers
API v1

Démarrage rapide

Effectuez votre première conversion avec l’API ConverterHQ en quelques minutes.

ConverterHQ reste simple pour une conversion unique et évolue vers des workflows complets sans changer de moteur d’exécution.

De la requête au résultat
AppFile / URL
ConverterHQ APIValidation
JobTasks
Output FileSigned download
Les requêtes rapides peuvent finir pendant l’attente; les travaux plus longs continuent derrière le même Job durable.

Votre première conversion

Créez une clé de test, envoyez un fichier et choisissez le format de sortie. Les SDK officiels gèrent automatiquement l’attente et le téléchargement du résultat.

from converterhq import ConverterHQ

# Reads CONVERTERHQ_API_KEY. hq_test_* keys automatically use the sandbox.
client = ConverterHQ()
result = client.convert(
    "report.docx",
    from_format="docx",
    to="pdf",
    wait=20,
)
result.save("report.pdf")

Quand le traitement devient asynchrone

Une requête rapide peut se terminer pendant la fenêtre d’attente; sinon l’API renvoie 202 avec un Job durable que vous pouvez interroger ou suivre par webhook.

Étapes suivantes

Utilisez Files pour les gros fichiers, Jobs et Tasks pour les workflows, puis les webhooks signés pour les automatisations de production.