ConverterHQDevelopers
API v1

Errores

Errores estables para máquinas con orientación de reintento y request IDs.

Los errores usan Problem Details más un código estable de ConverterHQ. La lógica debe ramificar por code y no por texto humano.

Problem Details

La respuesta incluye estado HTTP, code, detail, retryable, parámetro opcional y request_id.

Problem Details
{
  "type": "https://converterhq.io/developers/errors/file-password-protected",
  "title": "Password protected file",
  "status": 422,
  "code": "FILE_PASSWORD_PROTECTED",
  "retryable": false,
  "request_id": "req_..."
}

Reintentos

Reintenta automáticamente solo errores transitorios. Errores deterministas de archivo u opciones requieren cambiar la entrada.

Request IDs

Conserva X-Request-ID: enlaza la solicitud, el Job, TaskAttempts, eventos y diagnósticos de webhooks.