code est stable ; branchez dessus. message est destiné aux humains et peut changer. details est présent quand il y a quelque chose à ajouter : généralement un tableau de { field, message } pour une erreur de validation, ou un objet comme { "id": "..." } ou { "retryAfterSec": 5, "retryable": true }.
Une tâche acceptée qui échoue ensuite ne produit pas d’erreur HTTP. Elle signale à la place un code de défaillance de tâche.
Codes d’erreur de requête
Préférez
error.code au statut : VALIDATION_ERROR apparaît à la fois en 400 et en 422. Un 429 signifie que vous avez atteint l’une de vos propres limites ; un 503, que nous manquons de capacité pour le moment.
Retry-After
SurPOST /v1/async/task, POST /v1/async/task/batch et POST /v1/async/task/grid, chaque 429 et 503 porte un en-tête Retry-After en secondes. La plupart de ces codes portent aussi details.retryAfterSec et details.retryable: true. Les 429 de la limite de requêtes de l’edge ne portent ni l’un ni l’autre. Consultez Crédits et limites.
Limites de taille du corps
Refus lié à la région
REGION_UNSUPPORTED est décidé avant la mise en file : vous le savez immédiatement, au lieu d’attendre que la tâche échoue :
Erreurs par élément dans les lots et les grilles
SurPOST /v1/async/task/batch, une requête bien formée renvoie 200 même si des éléments échouent. Le statut décrit la requête ; results[].success décrit chaque tâche, et un élément en échec porte le même objet { code, message, details, timestamp } qu’une erreur de requête :
QUEUE_BACKPRESSURE ou SERVER_OVERLOADED indique son attente dans details.retryAfterSec. La requête elle-même n’échoue avec 400, 413, 429 ou 503 que lorsque tout le lot est refusé.
POST /v1/async/task/grid signale les points refusés de la même façon dans points[]. POST /v1/batches refuse tout le lot avec 400 si un élément est invalide, et enregistre comme REJECTED les éléments refusés à l’admission, par exemple pour INSUFFICIENT_CREDITS. Un élément dont l’idempotencyKey correspondait à une tâche créée avant le lot apparaît comme FAILED avec TASK_NOT_RETAINED dès que cette tâche n’est plus conservée. Consultez Lots et grilles.
Codes de défaillance des tâches
Une tâche qui échoue après sa mise en file se termine enFAILED. Le polling renvoie une chaîne error au premier niveau, et non l’objet d’erreur de requête :
response.error. La chaîne commence par un code ; branchez dessus.