code é estável; decida por ele. message é para pessoas e pode mudar. details aparece quando há algo a acrescentar: geralmente um array de { field, message } em um erro de validação, ou um objeto como { "id": "..." } ou { "retryAfterSec": 5, "retryable": true }.
Uma tarefa aceita que falha depois não gera erro HTTP. Em vez disso, ela informa um código de falha de tarefa.
Códigos de erro de requisição
Prefira
error.code ao status: VALIDATION_ERROR aparece como 400 e como 422. Um 429 significa que você atingiu um dos seus próprios limites; um 503, que nos falta capacidade no momento.
Retry-After
EmPOST /v1/async/task, POST /v1/async/task/batch e POST /v1/async/task/grid, todo 429 e 503 traz um cabeçalho Retry-After em segundos. A maioria desses códigos também traz details.retryAfterSec e details.retryable: true. Os 429 do limite de requisições da borda não trazem nenhum dos dois. Veja Créditos e limites.
Limites de tamanho do payload
Rejeição por região
REGION_UNSUPPORTED é decidido antes de a tarefa entrar na fila, então você fica sabendo na hora, em vez de esperar a tarefa falhar:
Erros por item em lotes e grades
EmPOST /v1/async/task/batch, uma requisição bem formada retorna 200 mesmo quando itens falham. O status descreve a requisição; results[].success descreve cada tarefa, e um item com falha traz o mesmo objeto { code, message, details, timestamp } de um erro de requisição:
QUEUE_BACKPRESSURE ou SERVER_OVERLOADED traz a espera em details.retryAfterSec. A própria requisição só falha com 400, 413, 429 ou 503 quando o lote inteiro é recusado.
POST /v1/async/task/grid informa os pontos recusados da mesma forma em points[]. POST /v1/batches rejeita o lote inteiro com 400 se algum item for inválido e guarda como REJECTED os itens que a admissão recusa, por exemplo por INSUFFICIENT_CREDITS. Um item cujo idempotencyKey correspondeu a uma tarefa criada antes do lote aparece como FAILED com TASK_NOT_RETAINED quando essa tarefa deixa de ser retida. Veja Lotes e grades.
Códigos de falha de tarefa
Uma tarefa que falha depois de entrar na fila termina emFAILED. O polling devolve uma string error no nível superior, não o objeto de erro de requisição:
response.error. A string começa com um código; decida por ele.