ConverterHQDevelopers
API v1

Conversioni sincrone e asincrone

Un unico contratto per lavori rapidi e di lunga durata.

ConverterHQ usa lo stesso Job in entrambi i modi; cambia solo quanto a lungo resta aperta la richiesta HTTP.

Header Prefer

Usa Prefer: wait=N per un’attesa limitata oppure Prefer: respond-async per ricevere subito un Job.

Prefer
Prefer: wait=20
Prefer: respond-async

Attesa limitata

Se la conversione termina nella finestra ricevi il risultato; altrimenti arriva 202 e il Job prosegue.

Pattern di produzione

Per carichi lunghi o elevati invia in asincrono e usa webhook firmati come segnale durevole di completamento.