Clase 04 · Módulo 05
Paginación, límites y reintentos
Paginación, límites y reintentos
Qué logras en esta clase
Traes listas completas y haces muchas llamadas sin que el servicio te corte.
- Configuras la paginación del nodo HTTP Request.
- Interpretas un 429 y calculas a qué ritmo llamar.
- Eliges entre reintentar, enviar por lotes o hacer un bucle con pausa.
02
Un número redondo es sospechoso
Si pediste una lista y llegaron justo 30, 50 o 100 elementos, probablemente hay más. Recibiste la primera página.
03
Por qué las listas llegan por partes
Un servicio no entrega diez mil registros en una sola respuesta: sería lento para todos. Los corta en páginas y tú pides una tras otra.
Un flujo que ignora esto trabaja bien en las pruebas y pierde datos cuando el negocio crece.
04
Tres estilos de paginación
| Estilo | Cómo pides la siguiente |
|---|---|
| Número de página | page=2, page=3 |
| Desplazamiento | offset=100 con limit=50 |
| Cursor o enlace | La respuesta trae la dirección o el código de la página siguiente |
Los nombres de los parámetros cambian de un servicio a otro. La documentación tiene una sección «Pagination» que dice cuál usa y cuál es el tamaño máximo de página.
05
Activar la paginación en el nodo
En el nodo HTTP Request, pulsa Add Option y elige Pagination. El campo Pagination Mode tiene tres valores:
- Off: una sola llamada.
- Update a Parameter in Each Request: para número de página o desplazamiento.
- Response Contains Next URL: para cuando la respuesta trae la dirección siguiente.
Con cualquiera de los dos modos activos, el nodo repite la llamada y junta los resultados.
06
Modo: cambiar un parámetro en cada llamada
- Elige Update a Parameter in Each Request.
- En Type indica dónde va el parámetro: Query o Body.
- En Name escribe el nombre que usa la API, por ejemplo
page. - En Value activa la expresión y escribe
{{ $pageCount + 1 }}.
$pageCount es la cantidad de páginas ya traídas. Parte en cero, por eso se le suma uno para pedir la página 1.
07
Si la API usa desplazamiento
La misma variable sirve: multiplicas por el tamaño de página.
{{ $pageCount * 50 }}Con páginas de 50, eso da 0, 50, 100. Si la primera página de tu servicio es la 0 y no la 1, usa {{ $pageCount }} a secas.
08
Modo: la respuesta trae la dirección siguiente
Elige Response Contains Next URL y escribe en Next URL una expresión que lea esa dirección desde la respuesta.
{{ $response.body["next-page"] }}$response es la última respuesta recibida: tiene body, headers y statusCode. Cambia next-page por el nombre real del campo en tu API.
09
El tamaño de página va aparte
Se define en Send Query Parameters, en los parámetros normales del nodo, no dentro de Pagination. En GitHub el parámetro es per_page y el máximo habitual es 100.
Páginas más grandes significan menos llamadas: usa el máximo permitido.
10
Decide cuándo se detiene
La paginación necesita una condición de término. En la sección Pagination del nodo, revisa los campos que definen cuándo se considera completa y cuántas páginas como máximo traer; sus nombres pueden variar según tu versión.
Pon siempre un máximo de páginas mientras pruebas.
11
Pide solo lo que necesitas
Traer todo para filtrar después es el camino caro. Filtra en el servicio: por fecha, por estado, por «modificado desde».
12
Los límites de uso
Todo servicio limita cuántas llamadas aceptas hacer en un tiempo dado. Algunos ejemplos documentados:
| Servicio | Límite |
|---|---|
| GitHub sin autenticar | 60 llamadas por hora |
| GitHub autenticado | 5.000 por hora |
| Google Sheets | 60 lecturas por minuto por usuario |
| Telegram | Cerca de 1 mensaje por segundo por chat |
Cambian con el tiempo. Antes de diseñar, busca «rate limits» en la documentación del servicio.
13
El 429: vas demasiado rápido
El código 429 significa que superaste el límite. En n8n el nodo falla con un mensaje del tipo «The service is receiving too many requests from you».
- No es una falla del servicio ni de tu clave.
- Insistir de inmediato lo empeora.
- GitHub puede responder 403 en vez de 429.
14
El servicio suele decir cuánto esperar
Muchos 429 traen la cabecera Retry-After con los segundos que debes esperar. Otros informan tu cuota en cada respuesta.
| Cabecera de GitHub | Dice |
|---|---|
x-ratelimit-limit | Tu máximo por hora |
x-ratelimit-remaining | Cuántas te quedan |
x-ratelimit-reset | Cuándo se reinicia |
Se ven con Include Response Headers and Status (clase 2).
15
Tres herramientas para ir más lento
| Herramienta | Sirve para |
|---|---|
| Retry On Fail | Fallas pasajeras, esperas de pocos segundos |
| Batching del HTTP Request | Espaciar muchas llamadas de un mismo nodo |
| Loop Over Items con Wait | Pausas largas o varios nodos por vuelta |
Las dos primeras son ajustes del nodo. La tercera es la del módulo 4, clase 3.
16
Retry On Fail
- Abre el nodo y ve a la pestaña Settings.
- Activa Retry On Fail.
- Define Max Tries y Wait Between Tries (ms).
Tiene topes: como máximo 5 intentos y 5.000 milisegundos entre ellos. Y el nodo HTTP Request no lee la cabecera Retry-After.
Resultado: cubre un tropiezo de segundos. Si el servicio pide esperar un minuto, no alcanza.
17
Batching: lotes con intervalo
En el nodo HTTP Request, Add Option y luego Batching:
- Items per Batch: cuántos ítems procesa antes de pausar. Cada ítem sigue siendo una llamada.
- Batch Interval (ms): la pausa entre lotes.
18
Cuándo pasar a Loop Over Items
- La pausa necesaria es larga, de minutos.
- En cada vuelta hay más de un nodo: llamar, guardar, avisar.
- Quieres registrar el avance para retomar si algo se cae.
El armado paso a paso está en el módulo 4. Aquí solo cambia el nodo que va dentro.
19
Esperar cada vez más
Cuando un servicio sigue respondiendo 429, la práctica recomendada por Google y GitHub es la espera exponencial: duplicar la pausa en cada intento, con un tope.
Google sugiere además sumar una fracción aleatoria de hasta un segundo y fijar un máximo de 32 o 64 segundos. Y siempre un número máximo de intentos: después, el flujo debe fallar y avisar.
20
No todo error se reintenta
| Código | ¿Reintentar? |
|---|---|
| 429 | Sí, esperando |
| 5xx | Sí, pocas veces |
| 400 | No: la petición está mal y seguirá mal |
| 401, 403 | No: es la credencial |
| 404 | No: es la dirección |
Reintentar un error tuyo solo gasta cuota. Arregla la causa.
21
Cuidado al reintentar un envío
Reintentar una lectura es inofensivo. Reintentar un POST puede crear el registro dos veces si la primera llamada llegó y lo que se perdió fue la respuesta.
22
Errores comunes
- Dar por completa una lista que era solo la primera página.
- Paginar sin tope de páginas.
- Dejar el tamaño de página por defecto y hacer diez veces más llamadas.
- Responder a un 429 llamando más seguido.
- Confiar en Retry On Fail para esperas que superan sus 5 segundos.
23
Lo que te llevas
- Las listas llegan por páginas; el nodo las recorre con Pagination.
$pageCountparte en cero y$responsees la última respuesta.- 429 es ritmo, no falla: se resuelve llamando más lento.
- Retry On Fail para tropiezos, Batching para espaciar, Loop con Wait para pausas largas.
- Solo se reintentan 429 y 5xx, y con cuidado si la llamada crea algo.
24
Hazlo ahora
En 15 minutos, con https://api.github.com/repos/n8n-io/n8n/releases:
- Agrega
per_pageigual a5y cuenta los ítems. - Activa Pagination en modo Update a Parameter in Each Request, con
pagey{{ $pageCount + 1 }}. - Fija un máximo de 3 páginas y ejecuta: deberías ver 15 ítems.
- Activa Include Response Headers and Status y ubica
x-ratelimit-remaining: cada página gastó una llamada. - Calcula cuántas páginas podrías traer en una hora sin credencial.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026
- Pagination in the HTTP Request node (documentación de n8n)docs.n8n.io ↗
- Handling API rate limits (documentación de n8n)docs.n8n.io ↗
- HTTP Request (documentación de n8n)docs.n8n.io ↗
- 429 Too Many Requests (MDN Web Docs)developer.mozilla.org ↗
- Using pagination in the REST API (GitHub)docs.github.com ↗
- Rate limits for the REST API (GitHub)docs.github.com ↗
- Usage limits (Google Sheets API)developers.google.com ↗
- Bots FAQ (Telegram)core.telegram.org ↗