Desarrolladores

Límites de uso

Peticiones por minuto de la API de Blogenia según el plan, cabeceras X-RateLimit y qué hacer ante un 429.

Cada clave tiene un límite de peticiones por minuto que depende del plan de tu organización.

Plan	Peticiones por minuto y clave
Free	Sin acceso a la API (`403` `plan_required`)
Starter	60
Pro	300

El contador es una ventana fija de 60 segundos por clave y cuenta todas las peticiones autenticadas con ella, también las que acaban en 400 o 404.

Cabeceras

Toda respuesta a una petición con clave incluye:

Cabecera	Significado
`X-RateLimit-Limit`	Peticiones permitidas por ventana.
`X-RateLimit-Remaining`	Peticiones que quedan en la ventana actual.
`X-RateLimit-Reset`	Segundos hasta que se reinicia la ventana.
`Retry-After`	Solo en `429`: segundos que debes esperar.

Las respuestas llevan Cache-Control: private, no-store.

Cuando superas el límite

Recibes 429 Too Many Requests con code: "rate_limited" y la cabecera Retry-After.

Respuesta 429

{
  "code": "rate_limited",
  "statusCode": 429,
  "error": "Too Many Requests",
  "message": "Has superado el límite de peticiones de tu plan. Inténtalo de nuevo en unos segundos.",
  "requestId": "0b8e2f6c-6d63-4d0e-9c1a-5d8f3c1d7a11"
}

Buenas prácticas

Espera Retry-After segundos antes de reintentar.
Guarda en tu servidor los artículos que ya has leído en lugar de pedirlos en cada visita de tu web.
Para enterarte de las novedades usa webhooks en lugar de consultar la lista cada pocos segundos.