Błędy używają Problem Details i stabilnego kodu ConverterHQ. Aplikacja powinna reagować na code, nie na tekst dla człowieka.
Problem Details
Odpowiedź zawiera status HTTP, code, detail, retryable, opcjonalny parameter i 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_..."
}Retryability
Automatycznie ponawiaj tylko błędy przejściowe. Deterministyczne błędy pliku lub opcji wymagają zmiany inputu.
Request IDs
Zachowaj X-Request-ID: łączy request, Job, TaskAttempts, eventy i diagnostykę webhooków.