Paginación¶
La petición puede regresar varios objetos. Por default, la paginación regresa 30 objetos con un maximo de 100.
Es posible especificar la página con el parámetro ?page
o cambiar el número de objetos con el parámetro ?page_size.
La información sobre la paginación de las peticiones se incluye en el link header. La respuesta del Link puede tener uno o más enlaces dependiendo del número de páginas de la petición. En caso de no tener un enlace es posible que la petición no cuente con páginas o la página de respuesta sea la única.
Ejemplo estructura Link:
<https://api.software.madkting.com/resource/?page=2>; rel="next",
<https://api.software.madkting.com/resource/?page=1>; rel="prev"
Los posibles valores de rel pueden ser:
| Nombre | Descripción |
|---|---|
| next | Siguiente página de la petición |
| Prev | Anterior página de la petición |
Cabeceras de la Paginación¶
| Nombre | Descripción |
|---|---|
| X-Pagination-Total-Count | Número de elementos en la petición |
| X-Pagination-Page-Count | Número de elementos de la página |
| X-Pagination-Current-Page | Índice de la página actual |
| X-Pagination-Per-Page | Número de elementos por página |