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.
{
"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.