Skip to content

🔍 Buscar productos por categoría

Este endpoint permite consultar todos los productos que pertenecen a una categoría específica. Es útil para mostrar los productos organizados por secciones en una tienda.


🧠 ¿Cuándo usar este endpoint?

  • Para mostrar productos filtrados por categoría (ej. "Ropa", "Tecnología", "Accesorios").
  • Cuando el usuario selecciona una categoría desde el frontend o el panel de administración.

🔓 No requiere autenticación

Este endpoint es público. Cualquier usuario puede consultar productos por categoría sin necesidad de estar autenticado.


📋 Headers

Nombre Tipo Descripción
Authorization String Token JWT para autenticación
Content-Type String Tipo de contenido de la solicitud

📦 Parámetros de la ruta

  • Método: GET
  • Ruta: /product/findByCategory/:category
Nombre Tipo Descripción
category String Nombre de la categoría a buscar

🚀 Ejemplo curl

curl -X GET "http://localhost:3000/api/product/findByCategory/ZAP" \
-H "Authorization: Bearer <tu_token_jwt_aqui>" \
-H "Content-Type: application/json"

📄 Respuesta exitosa

HTTP/1.1 200 OK
Content-Type: application/json
{
  "message": "Productos encontrados",
  "products": [
    {
      "id": "12345",
      "sku": "CARTO-006",
      "name": "Camiseta",
      "description": "Es una camiseta asi y asa",
      "price": 20.1,
      "category": "ZAP",
      "variants": [
        {
          "color": "azul",
          "size": "s",
          "stock": 50
        },
        {
          "color": "amarilla",
          "size": "m",
          "stock": 50
        }
      ],
      "images": [
        {
          "id": "d5e76d0d-44f8-4383-a796-84a792cb900e",
          "url": "https://..."
        }
      ]
    }
  ]
}

📄 Ejemplo de respuesta sin productos

{
  "message": "No se encontraron productos en esta categoría"
}

❌ Respuesta de error

Código Motivo Solución
404 Categoría no encontrada Verifica que la categoría exista y esté registrada correctamente
500 Error interno del servidor Contacta al administrador del sistema si el problema persiste.
---

📋 Donde ¿Donde consigo en ID de una categoria?

Para obtener el ID de una categoría, puedes consultar el endpoint de listar categorías. Este endpoint te proporcionará una lista de todas las categorías disponibles junto con sus IDs.