Rate Limits e Erros

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1745078400

HTTP/1.1 429 Too Many Requests
Retry-After: 12
Content-Type: application/json

{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Limite de 100 requisições por minuto atingido. Aguarde 12 segundos.",
    "status": 429
  }
}

async function requestWithRetry(url, options, maxAttempts = 3) {
  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
    const res = await fetch(url, options);

    if (res.status !== 429) return res;

    const retryAfter = parseInt(res.headers.get("Retry-After") ?? "5", 10);
    console.log(`Rate limited. Aguardando ${retryAfter}s (tentativa ${attempt}/${maxAttempts})`);
    await new Promise(r => setTimeout(r, retryAfter * 1000));
  }
  throw new Error("Número máximo de tentativas atingido");
}

GET /v1/conversations?page=3&per_page=50

{
  "data": [ ... ],
  "meta": {
    "page": 3,
    "per_page": 50,
    "total": 347,
    "total_pages": 7
  }
}

{
  "error": {
    "code": "CODIGO_DO_ERRO",
    "message": "Descrição legível do problema.",
    "status": 400
  }
}