Saltar al contenido principal

Paginación

Los endpoints que devuelven listas de resultados lo hacen de forma paginada. Use los parámetros de consulta page y limit para controlar la respuesta.

Parámetros

ParámetroTipoPor defectoDescripción
pageinteger1Número de página (inicia en 1)
limitinteger20Elementos por página (máx: 100)

Ejemplo

curl -X GET "https://api.nevatal.com/api/v1/patients?page=2&limit=10" 
  -H "Authorization: Bearer nvtl_su_clave_de_api"

Formato de respuesta

Todas las respuestas paginadas incluyen un objeto pagination:
{
  "data": [...],
  "pagination": {
    "page": 2,
    "limit": 10,
    "total": 142,
    "totalPages": 15
  }
}

Mejores prácticas

  • Use tamaños de página razonables (10-50 elementos) para la mayoría de los casos de uso.
  • Almacene en caché las respuestas cuando sea posible para reducir las llamadas a la API.
  • Use el campo total para construir la interfaz de usuario de paginación o para detectar cuándo ha obtenido todos los resultados.