Rate Limits
Límites por plan
Section titled “Límites por plan”Cada plan tiene límites específicos de requests y creación de links cortos vía API.
| Métrica | Community | Pro | Avance | Custom |
|---|---|---|---|---|
| RPM (requests/minuto) | 15 | 60 | 120 | Configurable |
| RPD (requests/día) | 100 | 10,000 | 50,000 | Configurable |
| Mensual (requests/mes) | 2,000 | 200,000 | 1,000,000 | Configurable |
| Short links (total) | 15 | 1,000 | 6,000 | Configurable |
| Batch (links por request) | — | 100 | 5,000 | Configurable |
| API Keys | 1 | 3 | 10 | Configurable |
Headers de respuesta
Section titled “Headers de respuesta”Cuando excedes el rate limit, la API responde con status 429 Too Many Requests:
{ "error": "Rate limit exceeded: 60 requests/min allowed"}Cuando excedes un límite de recursos, responde con 403 Forbidden:
{ "error": "Short link limit reached: 1000/1000. Upgrade your plan for more.", "upgrade": true}Batch API
Section titled “Batch API”El endpoint POST /api/v1/links/batch permite crear múltiples links en una sola petición.
- ≤ 100 links: Procesamiento síncrono (respuesta inmediata)
- > 100 links: Procesamiento asíncrono (retorna
job_idpara consultar estado)
Recomendaciones
Section titled “Recomendaciones”- Usa batch para crear múltiples links en una sola petición (Pro y Avance)
- Implementa retry con backoff exponencial para manejar
429 - Monitorea tu uso desde la vista de analíticas de cada API key
- El header
Retry-Afterindica cuántos segundos esperar antes de reintentar