ConverterHQDevelopers
API v1

Errori

Errori stabili e leggibili da macchina con indicazioni retry e request ID.

Gli errori usano Problem Details più un codice ConverterHQ stabile. La logica applicativa deve usare code, non il testo umano.

Problem Details

La risposta include stato HTTP, code, detail, retryable, parametro opzionale e 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_..."
}

Retry

Ritenta automaticamente solo errori transitori. Errori deterministici di file o opzioni richiedono input diversi.

Request IDs

Conserva X-Request-ID: collega richiesta, Job, TaskAttempts, eventi e diagnostica webhook.