Erreurs API et tentatives
Réponses d'erreur structurées, idempotence et récupération du traitement asynchrone.
Défaillances HTTP prévisibles#
401/403 indique un échec d'authentification ou de droits d'accès. 404 masque les objets inaccessibles. 409 signale des paramètres immuables, des importations déjà utilisées ou un état de tâche invalide. 413 applique des limites de taille, 422 valide les paramètres, et 429 applique une limitation de débit/concurrence.
Les défaillances de service commercial transitoire ou de file d'attente retournent 503. Relancez le traitement avec le même ID de tâche et les options identiques, en utilisant un backoff exponentiel et un budget de tentatives limité.
Exemple de récupération#
# 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"}}'Une tâche de traitement échouée ne peut pas être annulée simplement en supprimant la tâche. Consultez l'utilisation du compte et le support lors de l'investigation des écarts de règlement.
