Rate limits

How many requests per minute the Muvon API accepts per account and how to handle a 429.

Your account has a per-minute request limit, counting all your keys (test and live) together: 120 by default. If your volume needs more, Muvon can raise it on your account. Over the limit, the API answers 429 with rate_limit_error and a Retry-After header in seconds.

async function muvon(path, init = {}, attempt = 0) {
  const res = await fetch(`https://api.muvon.mx/api/v1${path}`, {
    ...init,
    headers: { Authorization: `Bearer ${process.env.MUVON_API_KEY}`, ...init.headers },
  });
  if (res.status === 429 && attempt < 3) {
    const wait = Number(res.headers.get("Retry-After") ?? 1);
    await new Promise((r) => setTimeout(r, wait * 1000));
    return muvon(path, init, attempt + 1);
  }
  return res;
}

Cache GET /places, GET /vehicle-types and GET /extras: they rarely change.
Use webhooks instead of polling bookings every few seconds.

Rate limits

Concepts

Rate limits

How many requests per minute the Muvon API accepts per account and how to handle a 429.

async function muvon(path, init = {}, attempt = 0) {
  const res = await fetch(`https://api.muvon.mx/api/v1${path}`, {
    ...init,
    headers: { Authorization: `Bearer ${process.env.MUVON_API_KEY}`, ...init.headers },
  });
  if (res.status === 429 && attempt < 3) {
    const wait = Number(res.headers.get("Retry-After") ?? 1);
    await new Promise((r) => setTimeout(r, wait * 1000));
    return muvon(path, init, attempt + 1);
  }
  return res;
}

Cache GET /places, GET /vehicle-types and GET /extras: they rarely change.
Use webhooks instead of polling bookings every few seconds.