Como usar la paginacion en las APIs
Lo que vas a conseguir
Hacer peticiones eficientes que devuelvan solo los resultados que necesitas, sin saturar la API ni tu sistema.
Por que es necesaria la paginacion
Algunas consultas pueden devolver cientos o miles de resultados (ej: todas las subastas activas, todos los contratos del ano). Devolverlos todos de golpe ralentiza la API, tu servidor y la red.
La solucion es la paginacion: divides los resultados en paginas de tamaño fijo.
Parametros comunes
Todas las APIs de Cargoffer, TRANSCEND y eCMR usan los mismos parametros de paginacion:
| Parametro | Que hace | Ejemplo |
|---|---|---|
page | Numero de pagina (empieza en 1) | page=1 |
limit | Resultados por pagina (max 100) | limit=20 |
sort | Campo por el que ordenar | sort=date |
order | Direccion: asc o desc | order=desc |
Ejemplo practico
bash
curl -X GET "https://api.pro.cargoffer.com/api/auction/active?page=1&limit=20&sort=date&order=desc" \
-H "Authorization: Bearer <token...a respuesta incluye:
```json
{
"data": [...],
"pagination": {
"page": 1,
"limit": 20,
"total": 156,
"pages": 8
}
}Con total y pages sabes cuantas paginas quedan por recorrer.
Filtros temporales (los mas usados)
bash
# Contratos de este mes
curl -X GET "https://api.pro.cargoffer.com/api/auction/contract/pending?dateFrom=2026-06-01&dateTo=2026-06-30" \
-H "Authorization: Bearer <token..."dateFrom` y `dateTo` aceptan formato ISO (YYYY-MM-DD).