Las rutas de búsqueda y listado devuelven páginas de resultados. La paginación evita respuestas demasiado grandes y permite reconciliar datos de forma estable.
Parámetros
| Parámetro | Tipo | Valor por defecto | Reglas |
|---|
pageNumber | integer | 1 | Debe ser mayor o igual que 1. |
pageSize | integer | 25 | Debe estar entre 1 y 1000. |
GET /v1/items/skus?pageNumber=1&pageSize=50
Respuesta
{
"results": [
{
"reference": "SKU-0001",
"name": "Mesa nordica blanca"
}
],
"pageNumber": 1,
"totalPages": 12,
"totalCount": 587,
"pageSize": 50
}
Recorrer todas las páginas
Empieza por la primera página
Llama con un pageSize que tu integración pueda procesar sin agotar el tiempo de espera.
Procesa los resultados
Guarda cada elemento usando su id o reference.
Avanza hasta la última página
Sigue llamando mientras pageNumber sea menor que totalPages.
Repite periódicamente
En integraciones críticas, combina paginación con webhooks para detectar cambios entre sincronizaciones.
page=1
while true; do
response=$(curl "https://api.bold-factory.com/v1/items/skus?pageNumber=$page&pageSize=100" \
-H "X-Api-Key: $BOLD_API_KEY")
total_pages=$(echo "$response" | jq ".totalPages")
echo "$response" | jq ".results[]"
if [ "$page" -ge "$total_pages" ]; then
break
fi
page=$((page + 1))
done
Usa páginas pequeñas durante pruebas. Sube pageSize solo cuando midas tiempos de respuesta, memoria y límites del sistema receptor.
