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?
Combina bien con esta guía: Devolver datos falsos realistas
Plantillas relacionadas
Última actualización: 2026-10-17