ConverterHQDevelopers
API v1

Conversões síncronas e assíncronas

Um único contrato para trabalhos rápidos e demorados.

O ConverterHQ usa o mesmo Job nos dois modos; muda apenas o tempo que a conexão HTTP espera.

Headers Prefer

Use Prefer: wait=N para uma espera limitada ou Prefer: respond-async para receber um Job imediatamente.

Prefer
Prefer: wait=20
Prefer: respond-async

Espera limitada

Se a conversão terminar dentro da janela, a resposta inclui o resultado; senão retorna 202 e o Job continua.

Padrão de produção

Para workloads longos ou volumosos, envie de forma assíncrona e use webhooks assinados como sinal durável de conclusão.