Descripción: Este es un servicio API REST de donde podemos obtener una lista de productos con datos básicos de un producto, pero suficientes para realizar pruebas en el desarrollo frontend.
Descripción de los modelos:
CATEGORÍA: Debemos asumir que los productos en tienda están categorizados, por esta razón existe el modelo Categoría, que representa las categorías con las que cuenta la tienda y por las que están categorizados los productos.
ATRIBUTOS:
name: Nombre visual de la categoría
name_unique: Nombre único de una categoría, recomendable para realizar filtros por categoría.
COLOR: Se asume que cada producto de la tienda puede tener distintos colores, de un producto A, podemos tener más de un color, así como un color puede estar asociado a varios productos.
ATRIBUTOS:
name: Nombre visual de un color (rojo, azul, blanco....)
value: Valor en hexadecimal de un color.
PRODUCTO: Es la representación de un producto en tienda, este puede pertenecer a varias categorías y puede tener varios colores, por ello tiene una relación de muchos a muchos con los modelos Color y Categoría.
ATRIBUTOS:
name: Nombre del producto
category: Categorías a las que pertenece un producto
colors: Colores a los que pertenece un producto
price: Precio unitario de un producto
description: Descripción extensa de u producto, en formato html
main_image: Imagen principal de un producto
second_image: Segunda imagen de un producto
third_image: Tercera imagen de un producto
visits: Número de visitas que tiene un producto.
1) Lista de Categorías
https://servicios.neunapp.com/api/tienda/categorias/lista/
Devuelve todas las categorías con las que cuenta la tienda, con atributos suficientes para realizar consultas.
2) Lista de Colores
https://servicios.neunapp.com/api/tienda/colores/lista/
Devuelve todos los colores registrados en la Tienda.
3) Lista de Productos en Tienda
https://servicios.neunapp.com/api/tienda/productos/lista/
Devuelve una lista de productos ordenados de mayor a menor número de visitas, y paginados de 12 en 12 registros.
4) Ver un producto en detalle
https://servicios.neunapp.com/api/tienda/producto/ID/
ID = número entero.
Devuelve un producto en específico por medio de un ID de producto, es obligatorio ingresar ID de producto.
5) Filtrar lista de productos
Los filtros se realizan haciendo una petición get y enviando parámetros por url, los parámetros que se aceptan son los siguientes, tener en cuenta las especificaciones:
name: Parámetro para filtrar productos por nombre, recibe cadenas como valores.
https://servicios.neunapp.com/api/tienda/productos/lista/?name=combo%20xiaomi
category: Parámetro para filtrar productos por categoría, recibe como parámetro el nombre único de la categoría.
https://servicios.neunapp.com/api/tienda/productos/lista/?category=telefonia
colors: Parámetro para filtrar productos por color, recibe como parámetro, número enteros separados por comas, estos números deben de ser los id de los colores registrados en la tienda.
https://servicios.neunapp.com/api/tienda/productos/lista/?colors=1,2
order: Parámetro para ordenar la lista de productos, se puede especificar los siguientes valores:
name = Indica que se debe ordenar por nombre
https://servicios.neunapp.com/api/tienda/productos/lista/?order=name
gprice = Indica que se debe ordenar por precio de forma descendente.
https://servicios.neunapp.com/api/tienda/productos/lista/?order=gprice
sprice = Indica que se debe ordenar por precio de forma ascendente.
https://servicios.neunapp.com/api/tienda/productos/lista/?order=sprice
* Si no se envía el parámetro order, por defecto devolverá una lista ordenada por número de visitas que tiene un producto.