Saltar al contenido principal

Paginación

Las operaciones de la API de Ordering que devuelven colecciones pueden limitar respuestas grandes, pero el soporte de paginación es específico de cada operación. Consulta la operación en la Referencia de la API antes de enviar estos parámetros.

Límite y desplazamiento​

Las operaciones heredadas que devuelven colecciones pueden aceptar:

  • limit — el número máximo de registros que se devolverán.
  • offset — la cantidad de registros coincidentes que se omitirán antes de devolver datos.
  • start — un alias heredado de offset cuando no está presente offset.

Por ejemplo, esto omite los primeros 100 registros coincidentes y devuelve como máximo los siguientes 100:

GET https://api.ordering.co/v400/en/YOUR_PROJECT/orders?offset=100&limit=100

Si están presentes tanto offset como start, offset tiene prioridad.

Página y tamaño de página​

Las operaciones que devuelven un bloque de paginación pueden aceptar en su lugar:

  • page — un número de página que empieza en 1.
  • page_size — la cantidad de registros solicitados por página, hasta el máximo configurado por la operación.

Su respuesta puede incluir total, from, to, current_page, page_size, total_pages y URLs de navegación. Por compatibilidad, el esquema de respuesta actual puede contener tanto first_page como la errata heredada fisrt_page.

No combines los mecanismos basados en página y en desplazamiento, a menos que la operación documente explícitamente esa combinación. Cuando page o la paginación forzada están activos, la consulta de modelo compartida no aplica por sí misma limit, offset ni start.

Los pedidos también tienen una guía especializada del panel de pedidos.