Guías

Paginación

Cómo paginar, ordenar y filtrar colecciones en la API de Inspow.

Los endpoints de listado devuelven resultados paginados y aceptan parámetros de query comunes.

Parámetros comunes

Parámetro	Descripción
`limit`	Resultados por página (por defecto `10`).
`offset`	Cuántos resultados saltar desde el inicio (por defecto `0`).
`page`	Número de página, empezando en `1`. Si lo envías, tiene prioridad sobre `offset` (`offset = (page - 1) × limit`).
`sort`	Orden en formato JSON, por ejemplo `{"lastName":1,"createdAt":-1}` (`1` ascendente, `-1` descendente).
`q` / `searchQuery`	Texto de búsqueda.
`query`	Filtro en formato JSON (estilo MongoDB), por ejemplo `{"status":"active"}`. El servidor solo acepta operadores seguros.

curl "https://api.inspow.tech/api/v1/restaurant/subscriptions?limit=20&page=2&query=%7B%22status%22%3A%22active%22%7D" \
  -H "Authorization: Bearer <TU_TOKEN>"

Algunos endpoints tienen además sus propios filtros, por ejemplo from / to (rango de fechas en formato ISO) en /audit-logs.

La respuesta

Los datos vienen en data (la lista de la página) y los metadatos en meta:

{
  "data": [ { "_id": "…" } ],
  "meta": {
    "totalRecords": 134,
    "page": 2,
    "limit": 20,
    "totalPages": 7,
    "hasMore": true,
    "requestId": "…"
  }
}

meta.total también existe, con el mismo valor que totalRecords, pero está obsoleto: usa totalRecords.