Simular una respuesta de API JSON paginada

Un mock GET que devuelve una página de tres registros falsos junto con page, per_page, total y next.

Esta plantilla devuelve una página de una colección JSON paginada — tres registros falsos junto a page, per_page, total y next — para que puedas construir el renderizado de listas, el scroll infinito o un cliente de paginación antes de que exista el endpoint real. Los registros se regeneran en cada llamada, lo que la convierte en una buena prueba para código que no debe dar por supuesto un orden estable.

Sustituye a un endpoint de API de terceros.

Payload de respuesta

{"data":[{"id":"{{faker.uuid}}","name":"{{faker.name}}","email":"{{faker.email}}"},{"id":"{{faker.uuid}}","name":"{{faker.name}}","email":"{{faker.email}}"},{"id":"{{faker.uuid}}","name":"{{faker.name}}","email":"{{faker.email}}"}],"page":1,"per_page":3,"total":42,"next":"{{mock.url}}?page=2"}

Campos que vale la pena conocer

Campo Lo que significa
data Un arreglo de registros falsos, tres por llamada a través de tokens {{faker.*}}.
page El número de página actual, codificado rígidamente en 1.
per_page El tamaño de página, codificado rígidamente en 3.
total El conteo total de registros, codificado rígidamente a 42.
next La URL a la siguiente página, construida mediante {{mock.url}}.

Crear el mock

curl -X POST https://quickmock.dev/api/mocks \
  -H 'Content-Type: application/json' \
  -d '{
  "method": "GET",
  "response_status": 200,
  "content_type": "application/json",
  "response_body": "{\"data\":[{\"id\":\"{{faker.uuid}}\",\"name\":\"{{faker.name}}\",\"email\":\"{{faker.email}}\"},{\"id\":\"{{faker.uuid}}\",\"name\":\"{{faker.name}}\",\"email\":\"{{faker.email}}\"},{\"id\":\"{{faker.uuid}}\",\"name\":\"{{faker.name}}\",\"email\":\"{{faker.email}}\"}],\"page\":1,\"per_page\":3,\"total\":42,\"next\":\"{{mock.url}}?page=2\"}"
}'

Llamarlo

curl https://quickmock.dev/m/<slug>

Lo que obtienes

GET /m/<slug> -> 200 a paginated list of 3 fake records
page/per_page/total/next describe the rest of the collection

En qué se diferencia de la realidad

Los tres registros son aleatorios y se regeneran en cada llamada en lugar de provenir de un conjunto de datos estable, y next apunta de nuevo a este mismo mock en lugar de a una segunda página real.

Fuentes

Preguntas frecuentes

¿El enlace next funciona de verdad?
Sí se puede seguir: next se construye con el token {{mock.url}}, así que resuelve a la dirección del propio mock. Seguirlo devuelve otra vez la misma página, no la página dos; en la siguiente pregunta se explica cómo encadenar una segunda página de verdad.
¿Cómo simulo una segunda página?
Crea un segundo mock donde la page esté puesta a 2 y su propio valor de next, y entonces apuntas el next del primer mock hacia allí.
¿Por qué los registros cambian entre las llamadas?
Se generan de forma fresca usando tokens de faker con cada solicitud. Eso es deliberado: un cliente que identifique un ítem de lista por el índice del array en lugar del id fallará de forma visible.

¿Listo para usarlo?

Ábrelo en el generador de mocks para ajustarlo primero

Combina bien con esta guía: Devolver datos falsos realistas

Plantillas relacionadas

← Todas las plantillas

Última actualización: 2026-10-17