ConverterHQDevelopers
API v1

Conversions synchrones et asynchrones

Un même contrat pour les traitements rapides et longs.

ConverterHQ utilise le même Job pour les conversions synchrones et asynchrones; seul le comportement d’attente HTTP change.

En-têtes Prefer

Utilisez Prefer: wait=N pour attendre un délai borné ou Prefer: respond-async pour recevoir immédiatement un Job.

Prefer
Prefer: wait=20
Prefer: respond-async

Attente bornée

Si la conversion termine pendant la fenêtre, la réponse contient le résultat; sinon un 202 indique que le Job continue en arrière-plan.

Modèle de production

Pour les traitements longs ou volumineux, soumettez de façon asynchrone et utilisez les webhooks signés comme signal durable de fin.