PDFHQ-Logo

Dokumente

DokumentationErste Schritte

API-Fehler und Wiederholungen

Strukturierte Fehlerantworten, Idempotenz und Wiederherstellung asynchroner Verarbeitung.

Server-seitige API-Schlüssel Signierte Speicher-Uploads

Vorhersehbare HTTP-Fehler#

401/403 zeigt Authentifizierungs- oder Berechtigungsfehler an. 404 blendet nicht zugängliche Objekte aus. 409 signalisiert unveränderliche Einstellungen, bereits verwendete Uploads oder ungültigen Task-Status. 413 erzwingt Größenlimits, 422 validiert Einstellungen und 429 ist Rate/Concurrency-Limiting.

Vorübergehende kommerzielle Service- oder Warteschlangenfehler geben 503 zurück. Versuche die Verarbeitung mit derselben Task-ID und identischen Optionen erneut, verwende exponentielles Backoff und ein begrenztes Wiederholungsbudget.

Wiederherstellungsbeispiel#

cURL
# Safe repeated processing attempt for the SAME task and options
curl -X POST https://api.pdfhq.io/v1/tasks/TASK_ID/process \
  -H 'x-api-key: YOUR_API_KEY' -H 'Content-Type: application/json' \
  -d '{"options":{"compression_level":"recommended"}}'

Eine fehlgeschlagene Verarbeitungsaufgabe kann nicht einfach durch Löschen der Aufgabe rückgängig gemacht werden. Überprüfe die Kontonutzung und kontaktiere den Support bei Unstimmigkeiten in der Abrechnung.

PDFHQ-Logo

PDF-Werkzeuge und Dokumentenanalyse. Dokumente vorbereiten, verstehen und bearbeiten.

© 2026 PDFHQ. Alle Rechte vorbehalten.