Categorías
Buscar Productos por Categoría
Cómo listar los productos públicos de una categoría específica usando el endpoint GET /stores//categories//products.
GET
List products by category
📌 Endpoint
GET /stores/{storeId}/categories/{categoryId}/products
Devuelve los productos públicos (no deshabilitados) que pertenecen a una categoría de una tienda.
Los productos se devuelven en el orden de position (ascendente).
🔐 Autenticación
- Ruta pública para consulta.
- La tienda debe existir y tener plan activo.
🧾 Parámetros de ruta
✅ Ejemplo de solicitud
🔎 Parámetros de consulta
🔄 Paginación por cursor
Para listas grandes (más de ~100 ítems), prefiere la paginación por cursor en lugar depage:
- Haz la primera llamada sin
cursor. - Si
hasMoreestrue, la respuesta trae el camponextCursor. - Envía ese
nextCursoren el parámetrocursorde la siguiente solicitud para buscar la página siguiente.
nextCursor, hasMore y limit:
cursorypageno pueden usarse juntos (400 INVALID_PAGINATION).- Cuando no hay productos en la categoría, el modo offset (sin
cursor) devuelve404 PRODUCTS_NOT_FOUND, mientras que el modo cursor devuelve200conproducts: [],nextCursor: nullyhasMore: false. nextCursor: nullconhasMore: falseindican el fin de la lista (la API responde200con array vacío).
📦 Respuesta exitosa (200)
La primera llamada (sincursor) ya devuelvenextCursoryhasMoreen la paginación, permitiendo iniciar la paginación por cursor sin llamadas extra.
⚠️ Posibles errores
400 INVALID_DATA→ parámetro inválido400 INVALID_PAGINATION_LIMIT→limitfuera del intervalo permitido (1a100)400 INVALID_PAGINATION_PAGE→pageinválida400 INVALID_PAGINATION_CURSOR→cursorinválido o malformado400 INVALID_PAGINATION→pageycursorutilizados juntos401 UNAUTHENTICATED→ no fue posible identificar al usuario de la suscripción403 NO_ACTIVE_SUBSCRIPTION→ plan inactivo o expirado404 STORE_NOT_FOUND→ tienda no encontrada404 PRODUCTS_NOT_FOUND→ ningún producto encontrado para la categoría (devuelto solo en modo offset cuandototales0; en modo cursor devuelve200con[])429 RATE_LIMIT_EXCEEDED→ límite de solicitudes por minuto excedido500 INTERNAL_SERVER_ERROR→ error interno503 SERVICE_UNAVAILABLE→ servicio o base de datos no disponible