Limites de débit

// med-client.js — Node.js >= 18
const BASE = "https://api.myexpressdriver.com/v1";
const API_KEY = process.env.MED_API_KEY; // med_live_...

const sleep = (ms) => new Promise((r) => setTimeout(r, ms));

/**
 * Appel API avec retry sur 429 et 5xx.
 * Respecte Retry-After ; sinon backoff exponentiel + jitter.
 */
async function medFetch(path, init = {}, { maxRetries = 5 } = {}) {
  for (let attempt = 0; attempt <= maxRetries; attempt++) {
    const res = await fetch(`${BASE}${path}`, {
      ...init,
      headers: {
        "X-Api-Key": API_KEY,
        "Content-Type": "application/json",
        ...init.headers,
      },
    });

    // Succès ou erreur non rejouable (4xx hors 429) : on rend la réponse telle quelle.
    if (res.status !== 429 && res.status < 500) {
      return res;
    }

    // Plus de tentatives : on rend la dernière réponse (l'appelant décide).
    if (attempt === maxRetries) {
      return res;
    }

    // 1. Priorité à Retry-After (en secondes) si fourni par le serveur.
    const retryAfter = Number(res.headers.get("retry-after"));
    let delayMs;
    if (Number.isFinite(retryAfter) && retryAfter >= 0) {
      delayMs = retryAfter * 1000;
    } else {
      // 2. Sinon : backoff exponentiel borné (1s, 2s, 4s, … max 30s) + jitter.
      const base = Math.min(1000 * 2 ** attempt, 30_000);
      const jitter = Math.random() * 250;
      delayMs = base + jitter;
    }

    await sleep(delayMs);
  }
}

// Exemple d'utilisation : lister les missions en cours.
const res = await medFetch("/transports?status=in_transit&limit=50");
if (!res.ok) {
  const problem = await res.json(); // { type, title, status, detail }
  throw new Error(`${problem.status} ${problem.title}: ${problem.detail ?? ""}`);
}
const { data, next_cursor } = await res.json();
console.log(`${data.length} missions`, next_cursor);