Categorías
Buscar Categorías
Aprende a listar las categorías de una tienda usando el endpoint GET /stores//categories.
GET
List categories
📌 Endpoint
GET /stores/{storeId}/categories
Devuelve todas las categorías de una tienda.
Las categorías se devuelven en el orden de position (ascendente), ideal para armar menú/listado en el frontend.
🔐 Autenticación
- Ruta pública para consulta.
- La tienda vinculada a
storeIddebe 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 categorías, el modo offset (sin
cursor) devuelve404 CATEGORIES_NOT_FOUND, mientras que el modo cursor devuelve200concategories: [],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 CATEGORIES_NOT_FOUND→ ninguna categoría encontrada (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