Ayuda y guíasAPI e integraciones › Rate limits y códigos de error

Rate limits y códigos de error

3 min de lectura · API e integraciones

Los rate limits impiden el abuso de la API. Al superarlos recibirá HTTP 429 con cabecera Retry-After.

Límites según el plan

Skúšobná / Estándar: 60 requests / minuto Profi: 300 requests / minuto Business: 1000 requests / minuto El límite es per-token, no per-user (puede tener varios tokens para distintos casos de uso).

Códigos de error

- 401 Unauthorized: token ausente o inválido - 403 Forbidden: el token no tiene permiso para esa acción (token read-only en un endpoint write) - 404 Not Found: recurso inexistente - 429 Too Many Requests: rate limit superado, espere Retry-After segundos - 5xx: server error, retry con exponential backoff

Buenas prácticas

- Cachee las responses de lectura (los datos de uptime no cambian cada segundo) - Use webhooks en lugar de polling siempre que sea posible - En operaciones batch use un delay entre requests