Paginación
Los endpoints que devuelven listas lo hacen por páginas.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
page | entero | Número de página, desde 1. |
page_size | entero | Resultados por página: 24 por defecto y 100 como máximo. |
Respuesta
Todas las listas tienen la misma forma, sin excepciones:
| Campo | Descripción |
|---|---|
count | Número total de resultados. |
next | URL de la página siguiente, o null si es la última. |
previous | URL de la página anterior, o null si es la primera. |
results | Los resultados de esta página. |
GET /templates?page_size=2 · 200
{
"count": 3,
"next": "https://creavibe.app/api/v1/templates?page_size=2&page=2",
"previous": null,
"results": [
{
"slug": "pop-art",
"title": "Pop Art",
"width": 1080,
"height": 1080,
"page_count": 1,
"format": "square",
"image_url": "https://creavibe.app/media/fichas/plantilla_Yt28o29.jpg"
},
{
"slug": "alarma-en-la-aldea",
"title": "Alarma en la aldea",
"width": 1080,
"height": 1080,
"page_count": 1,
"format": "square",
"image_url": "https://creavibe.app/media/fichas/plantilla_0jRtnBS.jpg"
}
]
}Para recorrer una lista completa, sigue la URL de next hasta que sea null. Las mismas URL van en la cabecera Link (rel="next" y rel="prev"), como en otras APIs:
Cabeceras de la respuesta
Link: <https://creavibe.app/api/v1/templates?page_size=2&page=2>; rel="next"Una página que no existe (por ejemplo, page=99 con 3 páginas) responde 404.