Datos

Este módulo proporciona acceso a datos de referencia del sistema AgroMarket como categorías, unidades de medida y productos.

Endpoints

GET /api/v1/data/categories

Obtiene todas las categorías de productos disponibles en el sistema.

URL: /api/v1/data/categories

Método: GET

Respuesta exitosa (200):

[
  {
    "_id": "64f8a1b2c3d4e5f6a7b8c9d0",
    "name": "Frutas",
    "image": "http://via.placeholder.com/150x150"
  },
  {
    "_id": "64f8a1b2c3d4e5f6a7b8c9d1",
    "name": "Verduras",
    "image": "http://via.placeholder.com/150x150"
  },
  {
    "_id": "64f8a1b2c3d4e5f6a7b8c9d2",
    "name": "Granos",
    "image": "http://via.placeholder.com/150x150"
  },
  {
    "_id": "64f8a1b2c3d4e5f6a7b8c9d3",
    "name": "Lácteos",
    "image": "http://via.placeholder.com/150x150"
  }
]

Respuesta de error (500):

{
  "message": "Error interno del servidor"
}

GET /api/v1/data/measureUnits

Obtiene todas las unidades de medida disponibles en el sistema.

URL: /api/v1/data/measureUnits

Método: GET

Respuesta exitosa (200):

[
  {
    "_id": "64f8a1b2c3d4e5f6a7b8c9d2",
    "name": "Kilogramos"
  },
  {
    "_id": "64f8a1b2c3d4e5f6a7b8c9d3",
    "name": "Litros"
  },
  {
    "_id": "64f8a1b2c3d4e5f6a7b8c9d4",
    "name": "Unidades"
  },
  {
    "_id": "64f8a1b2c3d4e5f6a7b8c9d5",
    "name": "Gramos"
  },
  {
    "_id": "64f8a1b2c3d4e5f6a7b8c9d6",
    "name": "Mililitros"
  }
]

Respuesta de error (500):

{
  "message": "Error interno del servidor"
}

GET /api/v1/data/products

Obtiene todos los productos disponibles en el sistema.

URL: /api/v1/data/products

Método: GET

Respuesta exitosa (200):

[
  {
    "_id": "64f8a1b2c3d4e5f6a7b8c9d5",
    "name": "Manzanas Rojas",
    "description": "Manzanas rojas frescas del valle",
    "price": 2.50,
    "quantity": 100,
    "image": "http://via.placeholder.com/300x200",
    "stock": 50,
    "measureUnit": "64f8a1b2c3d4e5f6a7b8c9d2",
    "measurement": "64f8a1b2c3d4e5f6a7b8c9d6",
    "category": "64f8a1b2c3d4e5f6a7b8c9d0",
    "user": "64f8a1b2c3d4e5f6a7b8c9d7"
  },
  {
    "_id": "64f8a1b2c3d4e5f6a7b8c9d8",
    "name": "Lechuga Fresca",
    "description": "Lechuga orgánica cultivada localmente",
    "price": 1.80,
    "quantity": 75,
    "image": "http://via.placeholder.com/300x200",
    "stock": 30,
    "measureUnit": "64f8a1b2c3d4e5f6a7b8c9d2",
    "measurement": "64f8a1b2c3d4e5f6a7b8c9d9",
    "category": "64f8a1b2c3d4e5f6a7b8c9d1",
    "user": "64f8a1b2c3d4e5f6a7b8c9d7"
  },
  {
    "_id": "64f8a1b2c3d4e5f6a7b8c9d9",
    "name": "Arroz Integral",
    "description": "Arroz integral orgánico de alta calidad",
    "price": 3.20,
    "quantity": 200,
    "image": "http://via.placeholder.com/300x200",
    "stock": 150,
    "measureUnit": "64f8a1b2c3d4e5f6a7b8c9d2",
    "measurement": "64f8a1b2c3d4e5f6a7b8c9da",
    "category": "64f8a1b2c3d4e5f6a7b8c9d2",
    "user": "64f8a1b2c3d4e5f6a7b8c9db"
  }
]

Respuesta de error (500):

{
  "message": "Error interno del servidor"
}

Códigos de Error Comunes

Código	Descripción
500	Error interno del servidor

Notas Importantes

Estos endpoints no requieren autenticación
Los datos se devuelven en formato JSON
Las imágenes son URLs que apuntan a recursos externos
Los IDs son únicos para cada entidad
Los productos incluyen referencias a categorías y unidades de medida
Los datos se actualizan en tiempo real
Estos endpoints son útiles para poblar formularios y listas desplegables
Los datos de referencia son estáticos y no cambian frecuentemente