Códigos de erro

{
  "success": false,
  "error": {
    "code": "VALIDATION",
    "message": "Payload inválido — veja details pra campos com erro.",
    "details": [
      {
        "path": "produtos.0.hunter_id",
        "message": "hunter_id obrigatório.",
        "code": "custom"
      }
    ]
  }
}

{
  "success": true,
  "data": {
    "processados": 3,
    "criados": 1,
    "atualizados": 1,
    "erros": 1,
    "resultados": [
      { "hunter_id": "A", "id_loja": "uuid-1", "acao": "criado" },
      { "hunter_id": "B", "id_loja": "uuid-2", "acao": "atualizado" },
      {
        "hunter_id": "C",
        "id_loja": null,
        "acao": "erro",
        "erro": "categoria_hunter_id 'X' não encontrada."
      }
    ],
    "parcial": true,
    "totalmente_falho": false
  }
}

async function robustPost(url, body, apiKey) {
  const MAX_RETRIES = 5;
  for (let attempt = 1; attempt <= MAX_RETRIES; attempt++) {
    const res = await fetch(url, {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "X-API-Key": apiKey,
      },
      body: JSON.stringify(body),
    });
    const json = await res.json();

    // 4xx (exceto 429) — não retentar
    if (res.status >= 400 && res.status < 500 && res.status !== 429) {
      throw new APIError(json.error);
    }

    // 429 — aguardar Retry-After
    if (res.status === 429) {
      const wait = parseInt(res.headers.get("Retry-After") ?? "60", 10);
      await sleep(wait * 1000);
      continue;
    }

    // 5xx — backoff exponencial
    if (res.status >= 500) {
      if (attempt === MAX_RETRIES) throw new APIError(json.error);
      await sleep(Math.pow(2, attempt) * 1000);
      continue;
    }

    return json;
  }
}