curl "https://api.gsengage.com/api/v1/leads?limit=50&page=1&apiKey=SUA_CHAVE"

{
  "data": [
    { "id": "507f1f77bcf86cd799439011", "name": "Maria Silva" },
    { "id": "507f1f77bcf86cd799439012", "name": "João Pereira" }
  ],
  "meta": {
    "limit": 50,
    "count": 2,
    "total": 137,
    "page": 1,
    "totalPages": 3
  }
}

curl "https://api.gsengage.com/api/v1/leads?orderBy=createdAt&orderDirection=desc&limit=50&page=1&apiKey=SUA_CHAVE"

curl "https://api.gsengage.com/api/v1/leads?search=maria@empresa.com&apiKey=SUA_CHAVE"

curl "https://api.gsengage.com/api/v1/prospections?routineIds=507f1f77bcf86cd799439011&apiKey=SUA_CHAVE"

curl "https://api.gsengage.com/api/v1/prospections?status=IN_PROGRESS&apiKey=SUA_CHAVE"

const BASE = "https://api.gsengage.com/api/v1";
const apiKey = process.env.GS_ENGAGE_API_KEY; // nunca deixe a chave no código

// Repete o pedido respeitando o Retry-After quando levar 429
async function callWithBackoff(url) {
  while (true) {
    const res = await fetch(url);
    if (res.status === 429) {
      const wait = Number(res.headers.get("Retry-After") || 5);
      await new Promise((r) => setTimeout(r, wait * 1000));
      continue; // tenta de novo depois de esperar
    }
    return res;
  }
}

// Baixa TODAS as páginas de uma listagem paginada (data + meta)
async function fetchAll(path, filtros = {}) {
  const todos = [];
  let page = 1;
  let totalPages = 1;

  do {
    const params = new URLSearchParams({
      ...filtros,
      limit: "100",
      page: String(page),
      apiKey,
    });
    const res = await callWithBackoff(`${BASE}${path}?${params}`);
    const json = await res.json();

    todos.push(...json.data);        // acumula os registros desta página
    totalPages = json.meta.totalPages; // condição de parada
    page++;
  } while (page <= totalPages);

  return todos;
}

// Exemplo: todas as prospecções em andamento de uma cadência
const prospeccoes = await fetchAll("/prospections", {
  status: "IN_PROGRESS",
  routineIds: "507f1f77bcf86cd799439011",
});
console.log(`Baixei ${prospeccoes.length} prospecções.`);

import os, time, requests

BASE = "https://api.gsengage.com/api/v1"
api_key = os.environ["GS_ENGAGE_API_KEY"]  # nunca deixe a chave no código

def call_with_backoff(url, params):
    while True:
        res = requests.get(url, params=params)
        if res.status_code == 429:
            wait = int(res.headers.get("Retry-After", "5"))
            time.sleep(wait)  # respeita o Retry-After e tenta de novo
            continue
        return res

def fetch_all(path, filtros=None):
    filtros = filtros or {}
    todos, page, total_pages = [], 1, 1

    while page <= total_pages:
        params = {**filtros, "limit": 100, "page": page, "apiKey": api_key}
        res = call_with_backoff(f"{BASE}{path}", params)
        json = res.json()

        todos.extend(json["data"])          # acumula os registros da página
        total_pages = json["meta"]["totalPages"]  # condição de parada
        page += 1

    return todos

# Exemplo: todas as prospecções em andamento de uma cadência
prospeccoes = fetch_all("/prospections", {
    "status": "IN_PROGRESS",
    "routineIds": "507f1f77bcf86cd799439011",
})
print(f"Baixei {len(prospeccoes)} prospecções.")