ConverterHQDevelopers
API v1

Fehler

Stabile maschinenlesbare Fehler mit Retry-Hinweisen und Request-IDs.

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.

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

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.