Limites de peticiones y buenas practicas

Lo que vas a conseguir

Entender los limites de cada API para disenar tu integracion sin bloqueos inesperados.

Por que existen limites

Compartimos la infraestructura entre todos los clientes. Los limites garantizan que nadie monopoliza los recursos y que la API responda rapido para todos.

Limites por API

API	Limite	Ventana	Uso tipico
Cargoffer	100 peticiones	Por minuto	Gestion de cargas, subastas
TRANSCEND	300 peticiones	Por minuto	Rutas, trafico, clima
eCMR	60 peticiones	Por minuto	Documentos, firmas

Como saber si te quedan peticiones

Cada respuesta incluye estos headers:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 45

Cuando X-RateLimit-Remaining llega a 0, las siguientes peticiones recibiran un error 429 Too Many Requests.

Estrategias para no quedarte sin limites

1. Cachea respuestas estaticas: Paises, codigos HS, tipos de vehiculo no cambian a menudo
2. Usa paginacion: En lugar de 10 peticiones de 10 resultados, haz 1 de 100
3. Webhooks: Para eventos en tiempo real en lugar de preguntar cada 5 segundos
4. Backoff exponencial: Si recibes un 429, espera 1s, luego 2s, luego 4s... antes de reintentar

import time
import requests

def llamada_segura(url, headers, max_intentos=3):
    for intento in range(max_intentos):
        r = requests.get(url, headers=headers)
        if r.status_code == 429:
            espera = 2 ** intento
            print(f"Limite alcanzado. Esperando {espera}s...")
            time.sleep(espera)
        else:
            return r
    raise Exception("Maximos intentos alcanzado")