ConverterHQDevelopers
API v1

Fouten

Stabiele machineleesbare fouten met retry guidance en request IDs.

Fouten gebruiken Problem Details plus een stabiele ConverterHQ-code. Applicaties moeten op code reageren, niet op menselijke tekst.

Problem Details

De response bevat HTTP-status, code, detail, retryable, optionele parameter en 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_..."
}

Retrybaarheid

Retry alleen tijdelijke fouten automatisch. Deterministische file- of option-errors vragen een gewijzigde input.

Request IDs

Bewaar X-Request-ID; die koppelt request, Job, TaskAttempts, events en webhookdiagnostiek.