Descripción General
Los endpoints de Fotos de Artículos permiten gestionar las imágenes asociadas a cada producto del restaurante. Esta funcionalidad es esencial para mostrar visualmente los productos en aplicaciones cliente, menús digitales y sistemas de punto de venta.
🎯 Características de las Fotos de Artículos
- Asociación uno a uno: Cada artículo puede tener una foto principal
- URL de imagen: Referencias a archivos de imagen almacenados
- Gestión de metadatos: Información adicional sobre las imágenes
- Validación de formato: Control de tipos de archivo permitidos
- Optimización de rendimiento: Gestión eficiente de recursos multimedia
Endpoints Disponibles
GET
/Master/Articulos/GetAllArticuloFoto
Obtiene todas las fotos de artículos registradas en el sistema. Este endpoint devuelve una lista completa de todas las imágenes asociadas a productos.
Parámetros de consulta:
- initialCatalog (string, requerido): Nombre de la base de datos
- userID (string, opcional): ID de usuario de la base de datos
- password (string, opcional): Contraseña de la base de datos
200 OK
Lista de fotos de artículos devuelta exitosamente
[
{
"articulo": "ART001",
"urlFoto": "/images/articulos/hamburguesa-clasica.jpg",
"descripcion": "Foto principal de la hamburguesa clásica",
"orden": 1
},
{
"articulo": "ART002",
"urlFoto": "/images/articulos/pizza-margarita.jpg",
"descripcion": "Foto de la pizza margarita",
"orden": 1
}
]
404 Not Found
No se encontraron fotos de artículos
500 Internal Server Error
Error interno del servidor
GET
/Master/Articulos/GetArticuloFoto/{articulo}
Obtiene la foto de un artículo específico por su ID. Este endpoint permite recuperar la imagen asociada a un producto en particular.
Parámetros de ruta:
- articulo (string, requerido): ID del artículo
Parámetros de consulta:
- initialCatalog (string, requerido): Nombre de la base de datos
- userID (string, opcional): ID de usuario de la base de datos
- password (string, opcional): Contraseña de la base de datos
200 OK
Foto del artículo encontrada y devuelta
{
"articulo": "ART001",
"urlFoto": "/images/articulos/hamburguesa-clasica.jpg",
"descripcion": "Foto principal de la hamburguesa clásica",
"orden": 1,
"fechaCreacion": "2024-01-15T10:30:00Z"
}
404 Not Found
Foto del artículo no encontrada
500 Internal Server Error
Error interno del servidor
POST
/Master/Articulos/AddArticuloFoto
Crea una nueva foto de artículo en el sistema. Este endpoint permite asociar una imagen a un producto existente.
Body (JSON):
{
"articulo": "ART001",
"urlFoto": "/images/articulos/nueva-hamburguesa.jpg",
"descripcion": "Nueva foto de la hamburguesa clásica",
"orden": 1
}
Parámetros de consulta:
- initialCatalog (string, requerido): Nombre de la base de datos
- userID (string, opcional): ID de usuario de la base de datos
- password (string, opcional): Contraseña de la base de datos
201 Created
Foto de artículo creada exitosamente
{
"articulo": "ART001",
"urlFoto": "/images/articulos/nueva-hamburguesa.jpg",
"descripcion": "Nueva foto de la hamburguesa clásica",
"orden": 1,
"fechaCreacion": "2024-01-15T11:00:00Z"
}
500 Internal Server Error
Error interno del servidor
PUT
/Master/Articulos/UpdateArticuloFoto/{articulo}
Actualiza la foto de un artículo existente en el sistema. Este endpoint permite modificar la información de la imagen asociada a un producto.
Parámetros de ruta:
- articulo (string, requerido): ID del artículo
Body (JSON):
{
"articulo": "ART001",
"urlFoto": "/images/articulos/hamburguesa-actualizada.jpg",
"descripcion": "Foto actualizada de la hamburguesa clásica",
"orden": 1
}
Parámetros de consulta:
- initialCatalog (string, requerido): Nombre de la base de datos
- userID (string, opcional): ID de usuario de la base de datos
- password (string, opcional): Contraseña de la base de datos
200 OK
Foto del artículo actualizada exitosamente
404 Not Found
Foto del artículo no encontrada
500 Internal Server Error
Error interno del servidor
DELETE
/Master/Articulos/DeleteArticuloFoto/{articulo}
Elimina la foto de un artículo del sistema. Este endpoint permite remover la imagen asociada a un producto.
Parámetros de ruta:
- articulo (string, requerido): ID del artículo
Parámetros de consulta:
- initialCatalog (string, requerido): Nombre de la base de datos
- userID (string, opcional): ID de usuario de la base de datos
- password (string, opcional): Contraseña de la base de datos
200 OK
Foto del artículo eliminada exitosamente
{
"message": "Articulo foto deleted successfully",
"articuloFoto": {
"articulo": "ART001",
"urlFoto": "/images/articulos/hamburguesa-clasica.jpg",
"descripcion": "Foto principal de la hamburguesa clásica",
"orden": 1
}
}
404 Not Found
Foto del artículo no encontrada
500 Internal Server Error
Error interno del servidor
Servicio Utilizado
IArticulosFotoService - Servicio para la gestión de fotos de artículos
- GetAllArticuloFoto(): Obtiene todas las fotos de artículos
- GetArticuloFoto(): Obtiene la foto de un artículo específico
- AddArticuloFoto(): Crea una nueva foto de artículo
- UpdateArticuloFoto(): Actualiza la foto de un artículo
- DeleteArticuloFoto(): Elimina la foto de un artículo