CreaVibeAPIVolver a CreaVibe

Paginación

Los endpoints que devuelven listas lo hacen por páginas.

Parámetros

NombreTipoDescripción
pageenteroNúmero de página, desde 1.
page_sizeenteroResultados por página: 24 por defecto y 100 como máximo.

Respuesta

Todas las listas tienen la misma forma, sin excepciones:

CampoDescripción
countNúmero total de resultados.
nextURL de la página siguiente, o null si es la última.
previousURL de la página anterior, o null si es la primera.
resultsLos 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.