Paginación

Todas las peticiones GET generales están paginadas. Recomendamos encarecidamente que respetes esta paginación y la implementes correctamente del lado de cliente.

Acerca de la paginación

La paginación permite que no se sobrecarguen tus aplicaciones al recibir datos desde Koibox. Por defecto, en las peticiones que listan resultados se devuelven 20 por página, con la opción de solicitar hasta 50 resultados en una sola petición.

Todas las peticiones con paginación se estructuran de la siguiente manera, con las líneas de paginación marcadas.

{
  "count": 100, // Cantidad de resultados
  "next": null, // Página siguiente
  "previous": null, // Página anterior
  "results": [] // Resultados
}

Puedes elegir cuántos resultados recibir por página y también a partir de qué resultado quieres que se devuelvan. Los parámetros a utilizar en la consulta son los siguientes:

limit (Número de resultados, hasta un máximo de 50)
offset (A partir de cuál resultado)

Ejemplo

Podemos realizar una petición en la que queremos 30 resultados a partir del quinto. Para este ejemplo utilizaremos el endpoint de listado de citas.

https://api.koibox.cloud/api/agenda/?limit=30&offset=5

La respuesta será la siguiente:

{
  "count": 7788,
  "next": "https://api.koibox.cloud/api/agenda/?limit=30&offset=35",
  "previous": "https://api.koibox.cloud/api/agenda/?limit=30",
  "results": []
}

Podemos observar que next y previous están definidos y nos informa de la anterior y siguiente página de resultados. Se deben utilizar estos enlaces de manera programática para que la paginación funcione correctamente.