Backend-Endpoints
Para que el frontend pueda mostrar de la mejor forma posible los datos, necesita saber a qué ruta debe acceder para hacer qué y qué datos esta recibiendo, la verdad aún se esta decidiendo la mejor forma de hacer esto y que sea optimó en el tiempo. Por ahora se van a presentar 6 rutas, las cuales son:
-
Endpoints que devuelven algo:
- GET “http://localhost:{port}/api/v1/products”: Este es la ruta que va a devolver un listado de productos a cualquier usuario, no necesita estar autenticado para verlos. Ejemplo de un producto devuelto por esta ruta:
{ "data": [ { "id": "a52184e4-a804-445f-ab06-f4fbfa64eca7", "nombre": "producto", "estadoActual": "creado", "precioMenor": 37689.9, "precioMayor": 20000, "stock": null, //da null en este caso porque el stock se crea a partir de la cantidad de tallas relacionadas a un producto "descripcion": "terceros zapatos", "descuento": 2, "fechaCreacion": "2024-08-15 23:56:05", "marca": "adidas", "colores": "["rojo"]", "tallas": "[{"numeroTalla":null,"cantidad":null,"estadoActual":null}]", "photos": "[{"url":null}]", "categories": "[{"nombre":"Casuales","descripcion":"Zapatos cómodos y versátiles para el día a día"}]" } ]}- Similar a esta ruta, son las otras dos que devuelven listados de productos, pero con más datos, la diferencia es que para poder usarce debe pasar dos filtros, el primero debe estar autenticado el usuario, segundo el rol debe coincidir con el esperado y ahí recien puede obtener el listado.
- Endpoints que devuelven void, pero con mensaje:
Esta son la mayoría de nuestras rutas, dado que estar devolviendo data en cada momento es un gasto innecesario de operaciones, por eso es que nos aseguramos de solo devolver data cuando deba hacerse, de resto no. Las rutas son:
-
POST “http://localhost:{port}/api/v1/users”: Con esta ruta el admin crea usuarios.
-
PUT “http://localhost:{port}/api/v1/users/statusUser/:id”: El admin cambia el status del usuario, cambiar el status implica eliminarlo, bloquearlo o desbloquearlo.
-
Endpoints que no devuelven nada: