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