Fehler nutzen Problem Details plus stabilen ConverterHQ-Code. Anwendungen sollten auf code statt auf menschlichen Text reagieren.
Problem Details
Antworten enthalten HTTP-Status, Code, Detail, retryable, optionalen Parameter und 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_..."
}Retrybarkeit
Nur transiente Infrastrukturfehler automatisch wiederholen. Deterministische Datei- oder Optionsfehler erfordern geänderte Eingaben.
Request IDs
Bewahren Sie X-Request-ID auf; sie verbindet Request, Job, Attempts, Events und Webhook-Diagnosen.