ConverterHQDevelopers
API v1

Błędy

Stabilne błędy maszynowe z informacją o retry i request ID.

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.

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_..."
}

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.