Pagination

{
  "data": [
    { "id": "-O9xAbCdEf", "transport_id": "M-54321", "status": "scheduled" }
  ],
  "next_cursor": "WyIyMDI2LTA2LTE2VDEwOjAwOjAwWiIsIi1POXgiXQ=="
}

curl -s "https://api.myexpressdriver.com/v1/transports?limit=50&cursor=WyIyMDI2LTA2LTE2VDEwOjAwOjAwWiIsIi1POXgiXQ==" \
  -H "X-Api-Key: med_live_xxxxxxxxxxxxxxxxxxxx"

// Node.js >= 18 (fetch global)
const BASE = "https://api.myexpressdriver.com/v1";
const API_KEY = process.env.MED_API_KEY; // med_live_...

/**
 * Récupère TOUS les éléments d'un endpoint paginé par curseur.
 * @param {string} path   Ex. "/transports"
 * @param {object} params Filtres et limit. Ex. { status: "in_transit", limit: 200 }
 * @returns {Promise<Array>} Tous les éléments, toutes pages confondues.
 */
async function fetchAll(path, params = {}) {
  const all = [];
  let cursor = null;

  do {
    const query = new URLSearchParams(params);
    if (cursor) query.set("cursor", cursor);

    const res = await fetch(`${BASE}${path}?${query}`, {
      headers: { "X-Api-Key": API_KEY },
    });

    if (res.status === 429) {
      // Respectez Retry-After puis reprenez SANS avancer le curseur.
      const wait = Number(res.headers.get("Retry-After") ?? 1);
      await new Promise((r) => setTimeout(r, wait * 1000));
      continue;
    }

    if (!res.ok) {
      // Erreur RFC 9457 (application/problem+json)
      const problem = await res.json();
      throw new Error(`${problem.status} ${problem.title}: ${problem.detail ?? ""}`);
    }

    const page = await res.json();
    all.push(...page.data);

    cursor = page.next_cursor; // null => dernière page
  } while (cursor !== null);

  return all;
}

// Exemple : toutes les missions en cours de transport (pages de 200).
const transports = await fetchAll("/transports", {
  status: "in_transit",
  limit: 200,
});
console.log(`${transports.length} missions récupérées`);

BASE="https://api.myexpressdriver.com/v1"
cursor=""

while :; do
  url="$BASE/transports?limit=200"
  [ -n "$cursor" ] && url="$url&cursor=$cursor"

  resp=$(curl -s -H "X-Api-Key: $MED_API_KEY" "$url")

  # … traiter le tableau .data ici …
  echo "$resp" | jq -r '.data[].transport_id'

  cursor=$(echo "$resp" | jq -r '.next_cursor // empty')
  [ -z "$cursor" ] && break    # next_cursor == null => fin
done