ConverterHQDevelopers
API v1

Conversiones síncronas y asíncronas

Un único contrato para trabajos rápidos y de larga duración.

ConverterHQ usa el mismo Job para ambos modos; solo cambia cuánto tiempo espera la conexión HTTP.

Cabeceras Prefer

Prefer: wait=N solicita una espera limitada; Prefer: respond-async devuelve un Job de inmediato.

Prefer
Prefer: wait=20
Prefer: respond-async

Espera acotada

Si termina dentro de la ventana se devuelve el resultado. Si no, se devuelve 202 mientras el Job continúa.

Patrón de producción

Para cargas largas o de gran volumen, envía en asíncrono y usa webhooks firmados como señal durable de finalización.