Límites de uso
Obtener una clave de APISofia API cuenta las peticiones en tres ventanas: 15 minutos, 24 horas y 30 días.
| Token | 15 minutos | 24 horas | 30 días |
|---|---|---|---|
| Clave personal (por cuenta) | 150 | 1000 | 10.000 |
| Cliente OAuth | 100 | 500 | 15.000 |
| Cliente OAuth, por persona autorizada (hasta 1000) | +10 | +25 | +100 |
Cabeceras
Cada respuesta te dice lo que queda, en el formato del IETF:
RateLimit: "15m";r=144;t=43, "24h";r=994;t=13543, "30d";r=9994;t=13543
RateLimit-Policy: "15m";q=150;w=900, "24h";q=1000;w=86400, "30d";q=10000;w=2592000r es el número de peticiones restantes, t los segundos hasta que la ventana se reinicia, q la cuota y w la ventana en segundos.
Cuando una ventana está llena
La respuesta es 429 rate_limit_exceeded, con una cabecera Retry-After y la ventana agotada en details. Espera ese tiempo antes de reintentar.
Usar la API de forma eficiente
- Registra un webhook en lugar de consultar una publicación en bucle.
- Usa
limithasta 100 para leer las listas en menos páginas. - Guarda en caché lo que cambia poco: plataformas, establecimientos, cuentas conectadas.