API-fouten en nieuwe pogingen
Gestructureerde foutresponsen, idempotentie en herstel van asynchrone verwerking.
Voorspelbare HTTP-fouten#
401/403 geeft aan dat verificatie of autorisatie is mislukt. 404 verbergt ontoegankelijke objecten. 409 geeft onveranderbare instellingen, reeds gebruikte uploads of ongeldige taakstatus aan. 413 dwingt groottelimieten af, 422 valideert instellingen en 429 beperkt snelheid/gelijktijdigheid.
Voorbijgaande commerciële service- of wachtrijfouten retourneren 503. Verwerk opnieuw met dezelfde taak-ID en identieke opties, met exponentiële backoff en een begrensd retry-budget.
Hersteelvoorbeeld#
# 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"}}'Een mislukte verwerkingstaak kan niet eenvoudig worden ongedaan gemaakt door de taak te verwijderen. Raadpleeg accountgebruik en ondersteuning bij het onderzoeken van afwikkelingsverschillen.
