Productos
Buscar Productos
Aprenda a listar productos de una tienda usando el endpoint GET /stores//products.
GET
List products
📌 Endpoint
GET /stores/{storeId}/products
Devuelve todos los productos de una tienda.
Los productos se devuelven en el orden de position (ascendente).
Los productos con disabled: true pueden aparecer en la respuesta para uso en el panel/admin.
🔐 Autenticación
- Ruta pública para consulta.
- La tienda debe existir y tener un plan activo.
🧾 Parámetros de ruta
✅ Ejemplo de petición
🔎 Parámetros de consulta
🔄 Paginación por cursor
Para listas grandes (más de ~100 elementos), prefiera la paginación por cursor en lugar depage:
- Realice la primera llamada sin
cursor. - Si
hasMoreestrue, la respuesta incluye el camponextCursor. - Envíe ese
nextCursoren el parámetrocursorde la siguiente petición para obtener la página siguiente.
nextCursor, hasMore y limit:
cursorypageno pueden usarse juntos (400 INVALID_PAGINATION).nextCursor: nullconhasMore: falseindican el final 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 adicionales.
⚠️ 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 registrado (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