API-Fehler und Wiederholungen
Strukturierte Fehlerantworten, Idempotenz und Wiederherstellung asynchroner Verarbeitung.
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#
# 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.
