Límites de uso

​

El presupuesto

​

Encabezados en cada respuesta

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 117
X-RateLimit-Reset: 42
RateLimit-Policy: 120;w=60
RateLimit: limit=120, remaining=117, reset=42
x-request-id: 8d0e5b8a-2f4c-4e1b-9a7d-0c3b5e6f7a81

​

Cuando superas el límite: 429

HTTP/1.1 429 Too Many Requests
Content-Type: application/problem+json; charset=utf-8
Retry-After: 18
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 18
RateLimit-Policy: 120;w=60
RateLimit: limit=120, remaining=0, reset=18

{
  "type": "https://docs.muveya.com/errors/common.too_many_requests",
  "title": "Demasiadas solicitudes",
  "status": 429,
  "detail": "Demasiadas solicitudes. Inténtalo de nuevo más tarde.",
  "instance": "/v1/orders",
  "code": "common.too_many_requests",
  "requestId": "5a1c7e2d-9b3f-4d6a-8e0c-2f4b6d8a0c1e"
}

​

Cómo esperar

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

async function muveyaGet(url, headers, attempts = 5) {
  for (let attempt = 1; attempt <= attempts; attempt += 1) {
    const response = await fetch(url, { headers });
    if (response.status !== 429) return response;

    const retryAfter = Number(response.headers.get("retry-after") ?? "1");
    await sleep(Math.max(1, retryAfter) * 1000);
  }
  throw new Error("Rate limit: gave up after several attempts");
}

import time
import requests

def muveya_get(session: requests.Session, url: str, attempts: int = 5, **kwargs):
    for _ in range(attempts):
        response = session.get(url, timeout=30, **kwargs)
        if response.status_code != 429:
            return response
        retry_after = int(response.headers.get("Retry-After", "1"))
        time.sleep(max(1, retry_after))
    raise RuntimeError("Rate limit: gave up after several attempts")

• Espera lo que indica Retry-After en cada 429. Reintentar antes solo suma solicitudes rechazadas a la misma ventana.
• Baja el ritmo antes de llegar al límite. Cuando X-RateLimit-Remaining se acerque a 0, espera X-RateLimit-Reset segundos antes de la siguiente ráfaga.
• Usa páginas grandes. Recorre las listas paginadas con limit=200 (consulta Paginación).
• Guarda en caché lo que casi no cambia. No necesitas leer sedes, bodegas y categorías en cada ejecución.
• Consulta las exportaciones con calma. Una consulta cada pocos segundos es suficiente mientras se genera una exportación (consulta Exportaciones).
• No ejecutes procesos superpuestos con la misma clave. Prográmalos uno después del otro.
• Usa una clave por integración. Cada clave tiene su propio presupuesto, así un proceso intenso no deja sin solicitudes a otro.

​

Páginas relacionadas

• Errores
• Webhooks: consultas periódicas dentro del presupuesto
• Scopes