La API REST para E-commerce es una solución creada como parte de un desafío técnico para evaluar conocimientos en desarrollo backend. Esta API proporciona funcionalidades esenciales para un sistema de comercio electrónico, incluyendo autenticación de usuarios, gestión de productos, carrito de compras y pedidos.
\nAutenticación JWT: Se utiliza JSON Web Tokens (JWT) para manejar la autenticación de usuarios.
\nEncriptación de contraseñas: Las contraseñas se almacenan en la base de datos encriptadas utilizando Bcrypt.
\nGestión de Productos: Se incluyen endpoints para crear, actualizar, eliminar y obtener detalles de productos.
\nGestión de Carrito de Compras: Funcionalidades para agregar productos al carrito, eliminar productos y obtener el contenido del carrito.
\nGestión de Pedidos: Se permite a los usuarios realizar pedidos, ver el historial de pedidos y obtener detalles de pedidos específicos.
\nExpress: Framework web para Node.js que se utiliza para construir la API REST.
\nPostgreSQL: Sistema de gestión de bases de datos relacional.
\nSequelize ORM: ORM (Object-Relational Mapping) para Node.js, utilizado para interactuar con la base de datos PostgreSQL.
\nBcrypt: Librería para el hash de contraseñas.
\nJson Web Token: Implementación de JWT para Node.js.
\nNodemailer: Módulo para enviar correos electrónicos, utilizado en la recuperación de contraseñas.
\nAutenticación de usuarios:
\nEndpoint: /api/auth/login
Método: POST
\nDescripción: Permite a un usuario iniciar sesión. Se requiere el email y la contraseña del usuario. Retorna un token de autenticación en caso de éxito.
\nRegistro de usuarios:
\nEndpoint: /api/auth/register
Método: POST
\nDescripción: Permite a un usuario registrarse en la aplicación. Se requieren el nombre, email y contraseña del usuario.
\nGestión de Productos:
\nEndpoint: /api/products
Métodos: GET (obtener todos los productos), POST (crear un nuevo producto)
\nDescripción: Permite crear, obtener, actualizar y eliminar productos.
\nGestión de Carrito de Compras:
\nEndpoint: /api/cart
Métodos: GET (obtener contenido del carrito), POST (agregar producto al carrito), DELETE (eliminar producto del carrito)
\nDescripción: Permite agregar productos al carrito, eliminar productos y obtener el contenido del carrito.
\nGestión de Pedidos:
\nEndpoint: /api/orders
Métodos: GET (obtener todos los pedidos), POST (realizar un nuevo pedido)
\nDescripción: Permite a los usuarios realizar pedidos, ver el historial de pedidos y obtener detalles de pedidos específicos.
\nCada endpoint incluye instrucciones detalladas sobre su uso y los parámetros requeridos, incluidos en esta documentación.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"25294531","collectionId":"a62339b7-ab2d-4cd1-9b73-65fd34c848f9","publishedId":"2sA3QmCZbk","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2024-05-18T22:15:38.000Z"},"item":[{"name":"Usuarios","item":[{"name":"Obtener mis datos de usuario","event":[{"listen":"test","script":{"id":"a7accf77-487b-4292-9a8b-c1169963c0ae","exec":["pm.test(\"Response status code is 200\", function () {"," pm.response.to.have.status(200);"," "," //si la prueba pasa entonces vamos a guardar el token en una variable de collection para ahorrarnos trabajo posteriormente"," if (pm.response.code === 200) {"," let jsonData = pm.response.json();"," pm.collectionVariables.set(\"token\", jsonData.token);"," }","});",""],"type":"text/javascript","packages":{}}}],"id":"62d22fa3-9a8c-4f1b-8226-048784e0590d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"jwt "}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"http://localhost:9000/api/v1/users/me","description":"GET /api/v1/users/me
Este endpoint permite a los usuarios autenticados obtener sus propios datos de usuario. La solicitud debe incluir el token JWT en el encabezado de autorización.
\nhttp://localhost:9000/api/v1/users/me\n\nAuthorization: jwt GET http://localhost:9000/api/v1/users/me\nAuthorization: jwt \n\nLa respuesta contiene los detalles del usuario autenticado.
\n{\n \"id\": \"UUID\",\n \"firstName\": \"text\",\n \"lastName\": \"text\",\n \"email\": \"text\",\n \"phone\": \"text\",\n \"role\": \"integer\",\n \"status\": \"text\",\n \"isVerified\": \"boolean\",\n \"passwordRequest\": \"UUID\",\n \"createdAt\": \"datetime\",\n \"updatedAt\": \"datetime\",\n \"userRoleId\": \"integer (puede ser nulo)\",\n \"user_role\": \"text (puede ser nulo)\"\n}\n\n{\n \"id\": \"13fbe739-7a63-466e-bf3d-58d39d206c45\",\n \"firstName\": \"Luis\",\n \"lastName\": \"Gomez\",\n \"email\": \"lufe023@gmail.com\",\n \"phone\": \"+123456789\",\n \"role\": 2,\n \"status\": \"active\",\n \"isVerified\": false,\n \"passwordRequest\": \"5402c26d-efe9-440f-b593-c94689f3f275\",\n \"createdAt\": \"2024-05-12T00:04:51.201Z\",\n \"updatedAt\": \"2024-05-25T15:02:07.258Z\",\n \"userRoleId\": null,\n \"user_role\": null\n}\n\n200 OK: La solicitud se procesó correctamente y se devolvieron los detalles del usuario.
401 Unauthorized: La solicitud no está autenticada correctamente.
500 Internal Server Error: Ocurrió un error en el servidor al procesar la solicitud.
Esta documentación incluye todos los detalles necesarios para comprender y utilizar el endpoint de obtención de datos del usuario autenticado, incluyendo ejemplos de solicitudes y respuestas, así como posibles códigos de estado.
\n","urlObject":{"path":["api","v1","users","me"],"host":["http://localhost:9000"],"query":[],"variable":[]}},"response":[],"_postman_id":"62d22fa3-9a8c-4f1b-8226-048784e0590d"},{"name":"Obtener un usuario por ID","event":[{"listen":"test","script":{"id":"a7accf77-487b-4292-9a8b-c1169963c0ae","exec":["pm.test(\"Response status code is 200\", function () {"," pm.response.to.have.status(200);"," "," //si la prueba pasa entonces vamos a guardar el token en una variable de collection para ahorrarnos trabajo posteriormente"," if (pm.response.code === 200) {"," let jsonData = pm.response.json();"," pm.collectionVariables.set(\"token\", jsonData.token);"," }","});",""],"type":"text/javascript","packages":{}}}],"id":"3399906b-03fb-4b05-a7e5-d38dbc78da35","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"jwt "}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"http://localhost:9000/api/v1/users/13fbe739-7a63-466e-bf3d-58d39d206c45","description":"GET /api/v1/users/:id
Este endpoint permite obtener los detalles de un usuario específico utilizando su ID. No se requieren variables en el cuerpo de la solicitud; el ID del usuario se envía como un parámetro en la URL.
\nbashCopiar códigohttp://localhost:9000/api/v1/users/:id\n\nid (UUID): El ID del usuario que se desea obtener.bashCopiar códigoGET http://localhost:9000/api/v1/users/13fbe739-7a63-466e-bf3d-58d39d206c45\n\nLa respuesta contiene los detalles del usuario con el ID especificado.
\n{\n \"id\": \"UUID\",\n \"firstName\": \"text (puede ser nulo)\",\n \"lastName\": \"text (puede ser nulo)\",\n \"email\": \"text\",\n \"phone\": \"text (puede ser nulo)\",\n \"role\": \"integer\",\n \"status\": \"text\",\n \"isVerified\": \"boolean\",\n \"passwordRequest\": \"UUID\",\n \"createdAt\": \"datetime\",\n \"updatedAt\": \"datetime\"\n}\n\n200 OK: La solicitud se procesó correctamente y se devolvieron los detalles del usuario.
400 Bad Request: El formato del ID del usuario es inválido.
404 Not Found: No se encontró un usuario con el ID especificado.
500 Internal Server Error: Ocurrió un error en el servidor al procesar la solicitud.
Asegúrese de que el ID del usuario sea un UUID válido.
\nEste endpoint solo proporciona información sobre el usuario. Para actualizar o eliminar un usuario, utilice los endpoints correspondientes.
\n{\n \"id\": \"UUID\",\n \"firstName\": \"text (puede ser nulo)\",\n \"lastName\": \"text (puede ser nulo)\",\n \"email\": \"text\",\n \"phone\": \"text (puede ser nulo)\",\n \"role\": \"integer\",\n \"status\": \"text\",\n \"isVerified\": \"boolean\",\n \"passwordRequest\": \"UUID\",\n \"createdAt\": \"datetime\",\n \"updatedAt\": \"datetime\"\n}\n\nGET /api/v1/users
Este endpoint permite obtener una lista paginada de todos los usuarios del sistema. La solicitud puede incluir parámetros de paginación opcionales offset y limit para controlar los resultados devueltos.
http://localhost:9000/api/v1/users?offset={offset}&limit={limit}\n\noffset (integer, opcional): El índice del primer usuario que se debe devolver. El valor predeterminado es 0.
limit (integer, opcional): El número máximo de usuarios que se deben devolver. El valor predeterminado es 10.
Authorization: jwt GET http://localhost:9000/api/v1/users?offset=0&limit=1\nAuthorization: jwt \n\nLa respuesta contiene la lista paginada de usuarios, junto con metadatos sobre la paginación.
\n{\n \"next\": \"URL\",\n \"prev\": \"URL\",\n \"offset\": \"integer\",\n \"limit\": \"integer\",\n \"count\": \"integer\",\n \"results\": [\n {\n \"id\": \"UUID\",\n \"firstName\": \"text (puede ser nulo)\",\n \"lastName\": \"text (puede ser nulo)\",\n \"email\": \"text\",\n \"phone\": \"text (puede ser nulo)\",\n \"role\": \"integer\",\n \"status\": \"text\",\n \"isVerified\": \"boolean\",\n \"passwordRequest\": \"UUID\",\n \"createdAt\": \"datetime\",\n \"updatedAt\": \"datetime\"\n }\n ]\n}\n\n{\n \"next\": \"http://localhost:9000/api/v1/users?offset=1&limit=1\",\n \"prev\": null,\n \"offset\": 0,\n \"limit\": 1,\n \"count\": 2,\n \"results\": [\n {\n \"id\": \"13fbe739-7a63-466e-bf3d-58d39d206c45\",\n \"firstName\": null,\n \"lastName\": null,\n \"email\": \"lufe023@gmail.com\",\n \"phone\": null,\n \"role\": 1,\n \"status\": \"active\",\n \"isVerified\": false,\n \"passwordRequest\": \"5402c26d-efe9-440f-b593-c94689f3f275\",\n \"createdAt\": \"2024-05-12T00:04:51.201Z\",\n \"updatedAt\": \"2024-05-16T03:18:01.595Z\"\n }\n ]\n}\n\n200 OK: La solicitud se procesó correctamente y se devolvió una lista de usuarios.
401 Unauthorized: La solicitud no está autenticada correctamente.
500 Internal Server Error: Ocurrió un error en el servidor al procesar la solicitud.
Asegúrese de proporcionar un token JWT válido en el encabezado de autorización.
\nUse los parámetros offset y limit para paginar a través de los resultados de los usuarios.
Este endpoint permite a los usuarios registrarse proporcionando su correo electrónico y contraseña.
\nemail (cadena, obligatorio): la dirección de correo electrónico del usuario. debe ser correo electronico
\npassword (cadena, obligatoria): la contraseña de la cuenta de usuario.
\nLa respuesta a esta solicitud es un objeto JSON que representa el estado de registro del usuario.
\n{\n \"type\": \"object\",\n \"properties\": {\n {\n \"type\": \"string\"\n },\n \"isVerified\":\n {\n \"type\": \"boolean\"\n },\n \"id\": \n {\n \"type\": \"string => uuid\"\n },\n {\"email\":\n \"type\": \"string\",\n }\n {\n \"role\":\n \"type\": \"integer\"\n }\n }\n}\n\nEste permite a los usuarios autenticarse y obtener un token para acceder a recursos protegidos.
\nemail (string, required): El correo del usuario
\npassword (string, required): La constraseña del usuario.
\nTras una solicitud exitosa, el servidor responde con un código de estado de 200 y un objeto JSON que contiene los siguientes campos:
\nmessage (string): un mensaje que indica el resultado de la autenticación.
\ntoken (string): El token de autenticación que se utilizará para acceder a los recursos protegidos, tambien tenemos una prueba que al dar positivo esta guardará el nuevo token en una variable global que podrá ser utiilizada en esta colección.
\nexpiresAt (string): La fecha y hora de vencimiento del token.
\nEste endpoint de API es una solicitud POST utilizada para enviar una solicitud de contraseña para usuarios. La solicitud debe ser enviada a http://localhost:9000/api/v1/users/passwordRequest/ con un cuerpo JSON en bruto que contenga el correo electrónico del usuario y los detalles del host frontend.
\nCuerpo de la Solicitud:
\nemail (cadena): El correo electrónico del usuario que solicita la contraseña.
\nfrontendHost (cadena): Los detalles del host frontend, este es una url en donde está el formulario para actualizar la contraseña.
\nTras una ejecución exitosa, la API devuelve una respuesta con un código de estado de 201 y un tipo de contenido JSON. El cuerpo de la respuesta contiene un mensaje confirmando la solicitud de contraseña exitosa.
\n{ \n \"message\": \"string\"\n}\n\nEste endpoin permite al usuario actualizar su contraseña enviando una solicitud HTTP PATCH a la URL especificada. La solicitud debe incluir el identificador único del usuario en la ruta URL este codigo el usuario lo tendrá en su correo electronico con todo y url, tambien en el cuerpo envie la nueva contraseña y confirmación, la conraseña quedará hasheada y encriptada en la DB
\nnewPassword (string): La nueva contraseña del usuario.confirmNewPassword (string): la confirmacón de la nueva contraseña, el backend va a confirmar que sea la misma.La respuesta será en formato JSON con estado 200. El esquema de respuesta es el siguiente:
\n{\n \"type\": \"object\",\n \"properties\": {\n \"message\": {\n \"type\": \"string\"\n }\n }\n}\n\nPATCH /api/v1/users/:id
Este endpoint permite actualizar los detalles de un usuario específico utilizando su ID. La solicitud debe incluir el token JWT en el encabezado de autorización y el usuario debe tener permisos de administrador.
\nhttp://localhost:9000/api/v1/users/:id\n\nid (UUID): El ID del usuario que se desea actualizar.Authorization: jwt
Content-Type: application/json
La solicitud debe incluir los campos que se desean actualizar. Todos los campos son opcionales.
\n{\n \"firstName\": \"text (opcional)\",\n \"lastName\": \"text (opcional)\",\n \"phone\": \"text (opcional)\",\n \"status\": \"text (opcional)\"\n}\n\nPATCH http://localhost:9000/api/v1/users/13fbe739-7a63-466e-bf3d-58d39d206c45\nAuthorization: jwt \nContent-Type: application/json\n{\n \"firstName\": \"Luis\",\n \"lastName\": \"Gomez\",\n \"phone\": \"+123456789\",\n \"status\": \"active\"\n}\n\nLa respuesta indica si el usuario se actualizó correctamente o si ocurrió un error.
\n{\n \"message\": \"User with ID: {id}, edited successfully!\"\n}\n\n{\n \"message\": \"Invalid ID\"\n}\n\n{\n \"message\": \"Error message\"\n}\n\n{\n \"message\": \"User with ID: 13fbe739-7a63-466e-bf3d-58d39d206c45, edited successfully!\"\n}\n\n200 OK: La solicitud se procesó correctamente y el usuario se actualizó.
400 Bad Request: Ocurrió un error con la solicitud.
404 Not Found: No se encontró un usuario con el ID especificado.
401 Unauthorized: La solicitud no está autenticada correctamente.
403 Forbidden: El usuario no tiene permisos para realizar esta acción.
500 Internal Server Error: Ocurrió un error en el servidor al procesar la solicitud.
Asegúrese de proporcionar un token JWT válido en el encabezado de autorización.
\nSolo los usuarios con permisos de administrador pueden actualizar la información de otros usuarios.
\nCarpeta para manejar todos los endpoints relacionados con los usuarios
\n","_postman_id":"102a6bbe-d58a-45ee-9b6c-a78d0e14f6d3"},{"name":"Productos","item":[{"name":"Ver un producto por ID","event":[{"listen":"test","script":{"id":"4b7c05ee-f5e1-42bb-b838-645f5862da10","exec":["pm.test(\"el estado de la respuesta debe ser 200\", function () {"," pm.expect(pm.response.code).to.equal(200);","});","","","pm.test(\"el tiempo de respuesta debe ser menos de 200ms\", function () {"," pm.expect(pm.response.responseTime).to.be.below(200);","});"],"type":"text/javascript","packages":{}}}],"id":"db1d6bd9-fd1b-4629-83a4-86ff7cc23266","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"Authorization","value":"jwt "}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"http://localhost:9000:/api/v1/products/57ce8176-d7d4-42a5-8ec9-142759df962a","description":"Este endpoint se utiliza para obtener un producto específico según su ID.
\nLa respuesta a esta solicitud es un objeto JSON que contiene la información del producto recuperado. El esquema de la respuesta es el siguiente:
\n{\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"string\"\n },\n \"Handle\": {\n \"type\": \"string\"\n },\n \"Title\": {\n \"type\": \"string\"\n }, \n \"Description\": {\n \"type\": \"string\"\n },\n \"SKU\": {\n \"type\": \"string\"\n },\n \"Grams\": {\n \"type\": \"number\"\n },\n \"Stock\": {\n \"type\": \"number\"\n },\n \"Price\": {\n \"type\": \"number\"\n },\n \"ComparePrice\": {\n \"type\": \"number\"\n },\n \"Barcode\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"number\"\n },\n \"createdBy\": {\n \"type\": \"string\"\n },\n \"createdAt\": {\n \"type\": \"string\"\n },\n \"updatedAt\": {\n \"type\": \"string\"\n },\n \"categoryDetails\": {\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"number\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"parent\": {\n \"type\": \"number\"\n },\n \"createdAt\": {\n \"type\": \"string\"\n },\n \"updatedAt\": {\n \"type\": \"string\"\n }\n }\n }\n }\n}\n\nEsta solicitud HTTP GET recupera una lista de productos pertenecientes a una categoría específica. La solicitud incluye el ID de la categoría, el offset y el límite como parámetros de consulta.
\nMétodo: GET
\nURL: http://localhost:9000:/api/v1/products/categoryId/:categoryId
Parámetros de consulta:
\noffset (número): El índice desde el cual se recuperan los productos.
limit (número): El número máximo de productos a recuperar.
Estado: 200
\nContent-Type: application/json
\nLa respuesta contiene un objeto JSON con las siguientes propiedades:
\nnext (string): El enlace a la siguiente página de productos.
prev (null): El enlace a la página anterior de productos, que es null en este caso.
offset (número): El offset usado en la solicitud.
limit (número): El límite usado en la solicitud.
total (número): El número total de productos en la categoría.
products (array): Un array de objetos de producto con las siguientes propiedades:
id (string): El identificador único del producto.
Handle (string): El identificador del producto.
Title (string): El título del producto.
Description (string): La descripción del producto.
SKU (string): El SKU del producto.
Grams (número): El peso del producto.
Stock (número): El stock disponible del producto.
Price (número): El precio del producto.
ComparePrice (número): El precio comparativo del producto.
Barcode (string): El código de barras del producto.
category (número): El ID de la categoría del producto.
createdBy (string): El usuario que creó el producto.
createdAt (string): La fecha y hora en que se creó el producto.
updatedAt (string): La fecha y hora en que se actualizó por última vez el producto.
categoryDetails (objeto): Un objeto que contiene los detalles de la categoría a la que pertenece el producto, con las siguientes propiedades:
id (número): El identificador único de la categoría.
name (string): El nombre de la categoría.
parent (número): El ID de la categoría padre.
description (null): La descripción de la categoría, que es null en este caso.
createdAt (string): La fecha y hora en que se creó la categoría.
updatedAt (string): La fecha y hora en que se actualizó por última vez la categoría.
Este endpoint recupera una lista de productos basada en una consulta de búsqueda.
\nURL de Solicitud:
\nGET http://localhost:9000:/api/v1/products/busqueda/:searchTerm?offset=0&limit=20\n\nParámetros de Consulta (Query Parameters):
\noffset (número, opcional): El desplazamiento para paginar los resultados.
\nlimit (número, opcional): El número máximo de resultados a devolver.
\nLa respuesta de esta solicitud es un esquema JSON que representa la estructura del cuerpo de la respuesta. El esquema JSON se puede utilizar para validar los datos de la respuesta contra una estructura predefinida.
\nCódigo de Estado: 200 OK
\nContent-Type: application/json
\nCuerpo de la Respuesta (Response Body):
\njsonCopiar código{\n \"next\": \"string\", // Enlace a la siguiente página de productos.\n \"prev\": \"string\", // Enlace a la página anterior de productos.\n \"offset\": \"number\", // Desplazamiento utilizado en la solicitud.\n \"limit\": \"number\", // Límite utilizado en la solicitud.\n \"total\": \"number\", // Número total de productos encontrados.\n \"products\": [\n {\n \"id\": \"string\", // Identificador único del producto.\n \"Handle\": \"string\", // Identificador manejable del producto.\n \"Title\": \"string\", // Título del producto.\n \"Description\": \"string\", // Descripción del producto.\n \"SKU\": \"string\", // Unidad de mantenimiento de existencias del producto.\n \"Grams\": \"number\", // Peso del producto en gramos.\n \"Stock\": \"number\", // Stock disponible del producto.\n \"Price\": \"number\", // Precio del producto.\n \"ComparePrice\": \"number\", // Precio comparativo del producto.\n \"Barcode\": \"string\", // Código de barras del producto.\n \"category\": \"number\", // Identificador de la categoría del producto.\n \"createdBy\": \"string\", // Usuario que creó el producto.\n \"createdAt\": \"string\", // Fecha y hora de creación del producto.\n \"updatedAt\": \"string\", // Fecha y hora de la última actualización del producto.\n \"categoryDetails\": {\n \"id\": \"number\", // Identificador único de la categoría.\n \"name\": \"string\", // Nombre de la categoría.\n \"parent\": \"number\", // Identificador de la categoría padre.\n \"description\": \"string\", // Descripción de la categoría.\n \"createdAt\": \"string\", // Fecha y hora de creación de la categoría.\n \"updatedAt\": \"string\" // Fecha y hora de la última actualización de la categoría.\n }\n }\n ]\n}\n\nEste endpoint se utiliza para obtener una lista de productos con un desplazamiento y límite específicos.
\noffset (número): El índice de inicio de los productos a recuperar.
\nlimit (número): El número máximo de productos a recuperar. El sistema se limitará automáticamente a 100 productos si se proporciona un valor superior a 100 para cuidar la salud del servidor de Base de Datos tambien se establecerá en 100 si limit está ausente o es inferior a 0
\nLa respuesta a esta solicitud es un objeto JSON que contiene la lista de productos recuperados, junto con metadatos adicionales. El esquema de la respuesta es el siguiente:
\n{\n \"type\": \"object\",\n \"properties\": {\n \"next\": {\n \"type\": \"string\"\n },\n \"prev\": {\n \"type\": \"null\"\n },\n \"offset\": {\n \"type\": \"number\"\n },\n \"limit\": {\n \"type\": \"number\"\n },\n \"total\": {\n \"type\": \"number\"\n },\n \"products\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"string\"\n },\n \"Handle\": {\n \"type\": \"string\"\n },\n \"Title\": {\n \"type\": \"string\"\n },\n \"Description\": {\n \"type\": \"string\"\n },\n \"SKU\": {\n \"type\": \"string\"\n },\n \"Grams\": {\n \"type\": \"number\"\n },\n \"Stock\": {\n \"type\": \"number\"\n },\n \"Price\": {\n \"type\": \"number\"\n },\n \"ComparePrice\": {\n \"type\": \"number\"\n },\n \"Barcode\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"number\"\n },\n \"createdBy\": {\n \"type\": \"string\"\n },\n \"createdAt\": {\n \"type\": \"string\"\n },\n \"updatedAt\": {\n \"type\": \"string\"\n },\n \"categoryDetails\": {\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"number\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"parent\": {\n \"type\": \"number\"\n },\n \"createdAt\": {\n \"type\": \"string\"\n },\n \"updatedAt\": {\n \"type\": \"string\"\n }\n }\n }\n }\n }\n }\n }\n}\n\nEste endpoint se utiliza para crear un nuevo producto con la información proporcionada en el cuerpo de la solicitud.
\nTitle (string, required): El título del producto.
\nDescription (string, required): La descripción del producto.
\nSKU (string, required): El código SKU del producto.
\nGrams (number, required): El peso del producto en gramos.
\nStock (number, required): La cantidad de stock disponible del producto.
\nPrice (number, required): El precio del producto.
\nComparePrice (number, required): El precio de comparación del producto.
\nBarcode (string, required): El código de barras del producto.
\ncategory (number, required): El ID de la categoría del producto. Puedes ver un listado completo de categorías en myserver/api/v1/categories.
\n{\n \"Title\": \"Título del Producto\",\n \"Description\": \"Descripción del Producto\",\n \"SKU\": \"SKU1237\",\n \"Grams\": 500,\n \"Stock\": 100,\n \"Price\": 29.99,\n \"ComparePrice\": 39.99,\n \"Barcode\": \"1234567890123\",\n \"category\": 1\n}\n\nLa respuesta a esta solicitud es un objeto JSON que contiene el producto creado. El esquema de la respuesta es el siguiente:
\n{\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"string\"\n },\n \"Handle\": {\n \"type\": \"string\"\n },\n \"Title\": {\n \"type\": \"string\"\n },\n \"Description\": {\n \"type\": \"string\"\n },\n \"SKU\": {\n \"type\": \"string\"\n },\n \"Grams\": {\n \"type\": \"number\"\n },\n \"Stock\": {\n \"type\": \"number\"\n },\n \"Price\": {\n \"type\": \"number\"\n },\n \"ComparePrice\": {\n \"type\": \"number\"\n },\n \"Barcode\": {\n \"type\": \"string\"\n },\n \"category\": {\n \"type\": \"number\"\n },\n \"createdBy\": {\n \"type\": \"string\"\n },\n \"createdAt\": {\n \"type\": \"string\"\n },\n \"updatedAt\": {\n \"type\": \"string\"\n },\n \"categoryDetails\": {\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"number\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"parent\": {\n \"type\": \"number\"\n },\n \"createdAt\": {\n \"type\": \"string\"\n },\n \"updatedAt\": {\n \"type\": \"string\"\n }\n }\n }\n }\n}\n\nEste endpoint se utiliza para actualizar un producto existente en la base de datos.
\nTitle (cadena): El título del producto.
\nDescription (cadena): La descripción del producto.
\nSKU (cadena): El código SKU del producto.
\nGrams (número): El peso del producto en gramos.
\nStock (número): La cantidad de stock disponible del producto.
\nPrice (número): El precio del producto.
\nComparePrice (número): El precio de comparación del producto.
\nBarcode (cadena): El código de barras del producto.
\ncategory (número): El ID de la categoría del producto. Puedes ver un listado completo de categorías en myserver/api/v1/categories.
\nLa respuesta a esta solicitud es un objeto JSON con el siguiente esquema:
\n{\n \"type\": \"object\",\n \"properties\": {\n \"message\": {\n \"type\": \"string\"\n }\n }\n}\n\nEste endpoint se utiliza para eliminar un producto existente en la base de datos.
\nLa respuesta a esta solicitud es un objeto JSON con el siguiente esquema:
\n{\n \"message\": {\n \"type\": \"string\"\n }\n}\n\nCarpeta asignada para manejar los endpoints relacionados con los productos
\n","_postman_id":"ca6fce1a-28fb-4bdc-aed1-c395cdb3a4e6"},{"name":"Listas Personalizadas","item":[{"name":"Crear Lista","id":"558eb08c-1662-4704-b0c9-0734471ad9f0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"jwt "}],"body":{"mode":"raw","raw":"{\n\t\"userId\": \"ee89de86-31cc-4135-8b3a-3d1e08a891b0\",\n\t\"nombreDeLista\": \"Regalos\",\n\t\"type\": \"customized\" //Favorites, customized, lo usamos para diferenciar cundo es una lista definida por los administradores de sistema o personalizada por el usuario customized\n}"},"url":"http://localhost:9000:/api/v1/list","description":"Este endpoint de la API se utiliza para crear una nueva lista personalizada de productos.
\nuserId (string): El identificador único del usuario.
\nnombreDeLista (string): El nombre de la lista.
\ntype (string): Indica el tipo de la lista, puede ser \"Favorites\" o \"customized\".
\nLa respuesta está en formato JSON con el siguiente esquema:
\n{\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\"type\": \"string\"},\n \"userId\": {\"type\": \"string\"},\n \"listName\": {\"type\": \"string\"},\n \"type\": {\"type\": \"string\"},\n \"updatedAt\": {\"type\": \"string\"},\n \"createdAt\": {\"type\": \"string\"}\n }\n}\n\n{\n \"id\": \"123\",\n \"userId\": \"456\",\n \"listName\": \"Regalos\",\n \"type\": \"customized\",\n \"updatedAt\": \"2022-01-01T12:00:00Z\",\n \"createdAt\": \"2022-01-01T12:00:00Z\"\n}\n\nEste endpoint se utiliza para añadir un producto a una lista personalizada.
\nlistId (uuid): El ID de la lista a la que se añadirá el producto.
\nproductId (uuid): El ID del producto que se añadirá a la lista.
\nEstado: 201
\nContent-Type: application/json
\n{\n \"listId\": \"uuid\",\n \"productId\": \"uuid\",\n \"updatedAt\": \"datetime\",\n \"createdAt\": \"datetime\"\n}\n\nObtener todos los productos de una lista personalizada.
\nThe response will be in JSON format with the following schema:
\n{\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\"type\": \"string\"},\n \"listName\": {\"type\": \"string\"},\n \"userId\": {\"type\": \"string\"},\n \"type\": {\"type\": \"string\"},\n \"createdAt\": {\"type\": \"string\"},\n \"updatedAt\": {\"type\": \"string\"},\n \"Products\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\"type\": \"string\"},\n \"Handle\": {\"type\": \"string\"},\n \"Title\": {\"type\": \"string\"},\n \"Description\": {\"type\": \"string\"},\n \"SKU\": {\"type\": \"string\"},\n \"Grams\": {\"type\": \"integer\"},\n \"Stock\": {\"type\": \"integer\"},\n \"Price\": {\"type\": \"integer\"},\n \"ComparePrice\": {\"type\": \"integer\"},\n \"Barcode\": {\"type\": \"string\"},\n \"category\": {\"type\": \"integer\"},\n \"createdBy\": {\"type\": \"string\"},\n \"createdAt\": {\"type\": \"string\"},\n \"updatedAt\": {\"type\": \"string\"}\n }\n }\n }\n }\n}\nEste endpoint se utiliza para eliminar un producto de una lista personalizada.
\nhttp://localhost:9000:/api/v1/list/remove-product?listId=42ab4283-b0d3-48d0-9743-1b82e3583dee&productId=uuid\n\nlistId (uuid): El ID de la lista de la que se eliminará el producto.
\nproductId (uuid): El ID del producto que se eliminará de la lista.
\nEstado: 204
\nContent-Type: application/json
\n{\n \"listId\": \"uuid\",\n \"productId\": \"uuid\",\n \"updatedAt\": \"string\",\n \"createdAt\": \"string\"\n}\n\nEndFragment
\n","urlObject":{"port":"","path":["api","v1","list","remove-product"],"host":["http://localhost:9000"],"query":[{"key":"listId","value":"42ab4283-b0d3-48d0-9743-1b82e3583dee"},{"key":"productId","value":"57ce8176-d7d4-42a5-8ec9-142759df962a"}],"variable":[]}},"response":[],"_postman_id":"c43ef892-05d1-489a-95a4-2b3863d0ec74"},{"name":"Eliminar Lista","id":"17427129-b873-4d78-a60f-4d1f88fa578b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"Authorization","value":"jwt "}],"url":"http://localhost:9000:/api/v1/list/42ab4283-b0d3-48d0-9743-1b82e3583dee","description":"StartFragment
\nEste endpoint se utiliza para eliminar una lista personalizada y sus productos asociados.
\nHTTP DELETE /api/v1/list/42ab4283-b0d3-48d0-9743-1b82e3583dee\n\nEsta solicitud no requiere un cuerpo de solicitud.
\nEstado: 200
\nContent-Type: application/json
\n{\n \"message\": \"string\"\n}\n\n\nEste endpoint permite al usuario agregar un producto a su lista de favoritos.
\nCuerpo de la Solicitud:
\nuserId (cadena, requerido): El ID del usuario.
\nproductId (cadena, requerido): El ID del producto que se agregará a la lista de favoritos.
\nRespuesta:
La respuesta será un objeto JSON con las siguientes propiedades:
listId (cadena): El ID de la lista de favoritos.
\nproductId (cadena): El ID del producto agregado a la lista de favoritos.
\nupdatedAt (cadena): La marca de tiempo cuando se actualizó la lista de favoritos.
\ncreatedAt (cadena): La marca de tiempo cuando se creó la lista de favoritos.
\nEsquema JSON:
\n{\n \"type\": \"object\",\n \"properties\": {\n \"listId\": {\"type\": \"string\"},\n \"productId\": {\"type\": \"string\"},\n \"updatedAt\": {\"type\": \"string\"},\n \"createdAt\": {\"type\": \"string\"}\n }\n}\n\nEste endpoint recupera una lista de productos favoritos para un usuario específico. La respuesta sigue el esquema JSON a continuación:
\nEsquema JSON:
\n{\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\"type\": \"string\"},\n \"listName\": {\"type\": \"string\"},\n \"userId\": {\"type\": \"string\"},\n \"type\": {\"type\": \"string\"},\n \"createdAt\": {\"type\": \"string\"},\n \"updatedAt\": {\"type\": \"string\"},\n \"Products\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\"type\": \"string\"},\n \"Handle\": {\"type\": \"string\"},\n \"Title\": {\"type\": \"string\"},\n \"Description\": {\"type\": \"string\"},\n \"SKU\": {\"type\": \"string\"},\n \"Grams\": {\"type\": \"integer\"},\n \"Stock\": {\"type\": \"integer\"},\n \"Price\": {\"type\": \"number\"},\n \"ComparePrice\": {\"type\": \"number\"},\n \"Barcode\": {\"type\": \"string\"},\n \"category\": {\"type\": \"integer\"},\n \"createdBy\": {\"type\": \"string\"},\n \"createdAt\": {\"type\": \"string\"},\n \"updatedAt\": {\"type\": \"string\"}\n }\n }\n }\n }\n}\n\nEste endpoint permite al usuario eliminar un producto de su lista de favoritos.
\nURL:
\nhttp://localhost:9000:/api/v1/favoritelist/remove-product?userId=ee89de86-31cc-4135-8b3a-3d1e08a891b0&productId=\n\nParámetros de Consulta:
\nuserId (cadena, requerido): El ID del usuario.
\nproductId (cadena, requerido): El ID del producto que se eliminará de la lista de favoritos.
\nRespuesta:
La respuesta será un objeto JSON con las siguientes propiedades:
Ejemplo de Respuesta:
\n{\n \"message\": \"Producto eliminado de la lista de favoritos.\"\n}\n\nLa lista de favoritos se crea automáticamente en la base de datos al momento de crear un usuario en el sistema. El sistema identifica estas listas a través de su tipo, que será type: \"Favorites\", y el ID del usuario.
Todo el manejo de la lista de favoritos se realiza automáticamente en el backend, por lo que el programador frontend no necesita preocuparse por estos detalles. Los endpoints disponibles permiten agregar productos, obtener productos y eliminar productos de la lista de favoritos de un usuario.
\n","_postman_id":"2945e49f-7b0c-4663-8710-3dd5c7089263"},{"name":"Categorias","item":[{"name":"Obtener una categoria por ID","event":[{"listen":"test","script":{"id":"4b7c05ee-f5e1-42bb-b838-645f5862da10","exec":["pm.test(\"el estado de la respuesta debe ser 200\", function () {"," pm.expect(pm.response.code).to.equal(200);","});","","pm.test(\"el tiempo de respuesta debe ser menos de 200ms\", function () {"," pm.expect(pm.response.responseTime).to.be.below(200);","});",""],"type":"text/javascript","packages":{}}}],"id":"174ceb17-b323-47d5-a6d2-881e9e9d392b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"Authorization","value":"jwt "}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"http://localhost:9000/api/v1/categories/7","description":"http://localhost:9000/api/v1/categories/:id\n\nhttp://localhost:9000/api/v1/categories/7\n\n{\n \"id\": 7,\n \"name\": \"Prueba\",\n \"parent\": 0,\n \"description\": \"Esta es una categoría de Prueba\",\n \"createdAt\": \"2024-06-01T16:01:31.498Z\",\n \"updatedAt\": \"2024-06-01T16:01:31.498Z\"\n}\n\n{\n \"id\": 7, // int\n \"name\": \"Prueba\", // string\n \"parent\": 0, // int\n \"description\": \"Esta es una categoría de Prueba\", // string\n \"createdAt\": \"2024-06-01T16:01:31.498Z\", // string (ISO 8601 date)\n \"updatedAt\": \"2024-06-01T16:01:31.498Z\" // string (ISO 8601 date)\n}\n\nEste endpoint se utiliza para obtener una lista de productos con un desplazamiento y límite específicos.
\noffset (número): El índice de inicio de los productos a recuperar.
\nlimit (número): El número máximo de productos a recuperar. El sistema se limitará automáticamente a 100 productos si se proporciona un valor superior a 100 para cuidar la salud del servidor de Base de Datos tambien se establecerá en 100 si limit está ausente o es inferior a 0
\nLa respuesta a esta solicitud es un objeto JSON que contiene la lista de productos recuperados, junto con metadatos adicionales. El esquema de la respuesta es el siguiente:
\n{\n \"type\": \"object\",\n \"properties\": {\n \"next\": {\n \"type\": \"string\"\n },\n \"prev\": {\n \"type\": \"null\"\n },\n \"offset\": {\n \"type\": \"number\"\n },\n \"limit\": {\n \"type\": \"number\"\n },\n \"total\": {\n \"type\": \"number\"\n },\n \"categories\": {\n \"type\": \"array\",\n \"items\": {\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"number\"\n },\n \"name\": {\n \"type\": \"string\"\n },\n \"parent\": {\n \"type\": \"number\"\n },\n \"createdAt\": {\n \"type\": \"string\"\n },\n \"updatedAt\": {\n \"type\": \"string\"\n }\n }\n }\n }\n }\n}\n\nparent
\nEl valor de parent se refiere a otra categoría que sería la categoría padre.
En caso de no tener una categoría superior el valor será 0.
Si tiene algun otro valor significa que es subcategoria de la categoria que indica el valor o ID.
Ejemplo: en el modelo puede existir una categoria Automovil con el id[1], a su vez pueden existir las subcategorias accesorios id[401] y la subcategoria repuestos id[402] en ambos casos de estas subcategorias el valor parent seria 1 que representa al id de la categoria superior automovil
\nAutomovil:{
subcategoria_1: \"accesorios\",
subcategoria_2: \"repuestos\"
}
\"parent\": {
\"type\": \"number\"
}
Este endpoint se utiliza para crear una nueva categoría con la información proporcionada en el cuerpo de la solicitud.
\nname (string, required): El nombre de la categoría.
\ndescription (string, required): La descripción de la categoría.
\nparent (number, required): El ID de la categoría principal. Si es una categoría de nivel superior, se debe proporcionar 0.
\n{\n \"name\": \"Nombre de la Categoría\",\n \"description\": \"Descripción de la Categoría\",\n \"parent\": 0\n}\nLa respuesta a esta solicitud es un objeto JSON que contiene la categoría creada. El esquema de la respuesta es el siguiente:
\n{\n \"id\": \"string\",\n \"name\": \"string\",\n \"parent\": \"number\",\n \"description\": \"string\",\n \"updatedAt\": \"string\",\n \"createdAt\": \"string\"\n}\nEste endpoint se utiliza para actualizar un producto existente en la base de datos.
\nname (cadena): El nombre del producto.
\ndescription (cadena): La descripción del producto.
\nparent (número): El ID del padre del producto.
\nLa respuesta a esta solicitud es un objeto JSON con el siguiente esquema:
\n{\n \"type\": \"object\",\n \"properties\": {\n \"message\": {\n \"type\": \"string\"\n }\n }\n}\n\nEste endpoint se utiliza para eliminar una categoría existente en la base de datos.
\nmyserver/api/v1/categories/:idLa respuesta a esta solicitud es un objeto JSON con el siguiente esquema:
\n{\n \"message\": {\n \"type\": \"string\"\n }\n}\n\nEste endpoint se utiliza para crear un carrito.
\ncartId (en la URL): El ID del carrito al que se desea agregar el producto.status (cadena): El estado de la operación.
id (cadena): El ID del producto agregado al carrito.
userId (cadena): El ID del usuario al que pertenece el carrito.
updatedAt (cadena): La fecha y hora de la última actualización.
createdAt (cadena): La fecha y hora de creación del producto en el carrito.
La respuesta tendrá un código de estado 201 y un cuerpo en formato JSON.
\n","urlObject":{"port":"","path":["api","v1","cart"],"host":["http://localhost:9000"],"query":[],"variable":[]}},"response":[],"_postman_id":"1c70971e-2b65-4a8a-b48a-d4650d0031fe"},{"name":"Agregar Producto al Carrito","id":"9f403d23-4634-4b36-a256-f17aa8eb3688","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Authorization","value":"jwt "},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\"productId\": \"\", \"quantity\": 2}"},"url":"http://localhost:9000:/api/v1/cart//products","description":"Este endpoint permite al cliente añadir un producto al carrito especificado. suma la cantidad cada vez que es enviado, si lo crea con 1 y lo vuelve a enviar la cnatidad que envíe la segunda vez se sumará a lo que ya existe
\nMétodo: POST
URL: http://localhost:9000:/api/v1/cart//products
Cuerpo:
\nproductId (string): El ID del producto que se va a añadir al carrito.
\nquantity (number): La cantidad del producto que se va a añadir al carrito.
\nLa respuesta está en formato JSON y tiene el siguiente esquema:
\nJSON:
\njsonCopiar código{\n \"type\": \"object\",\n \"properties\": {\n \"id\": {\n \"type\": \"string\"\n },\n \"cartId\": {\n \"type\": \"string\"\n },\n \"productId\": {\n \"type\": \"string\"\n },\n \"quantity\": {\n \"type\": \"number\"\n },\n \"updatedAt\": {\n \"type\": \"string\"\n },\n \"createdAt\": {\n \"type\": \"string\"\n }\n }\n}\n\nEstado: 201
Content-Type: application/json
Este endpoint permite al cliente actualizar la cantidad de un producto específico en el carrito.
\nMétodo: PATCH
URL: http://localhost:9000:/api/v1/cart/products/{{cartItemId}}
Encabezados:
\nContent-Type: application/jsonCuerpo (JSON):
\njsonCopiar código{\n \"quantity\": 0\n}\n\nLa respuesta es un objeto JSON con el siguiente esquema:
\nid (string): El ID del producto en el carrito
cartId (string): El ID del carrito
productId (string): El ID del producto
quantity (number): La cantidad actualizada del producto en el carrito
createdAt (string): La fecha y hora de creación
updatedAt (string): La fecha y hora de la última actualización
Solicitud:
\njsonCopiar código{\n \"quantity\": 3\n}\n\nRespuesta:
\njsonCopiar código{\n \"id\": \"5c3fa1d3-3d2a-417f-b3df-af706a8778f7\",\n \"cartId\": \"12345678-1234-1234-1234-123456789012\",\n \"productId\": \"87654321-4321-4321-4321-210987654321\",\n \"quantity\": 3,\n \"createdAt\": \"2023-05-16T00:00:00.000Z\",\n \"updatedAt\": \"2023-05-16T01:00:00.000Z\"\n}\n\nEste endpoint recupera la lista de productos en un carrito específico identificado por el cartId.
Método: GET
URL: http://localhost:9000:/api/v1/cart//products
Cuerpo de la Solicitud:
Esta solicitud no requiere un cuerpo de solicitud.
La respuesta es un arreglo JSON que contiene objetos con las siguientes propiedades:
\nid (string): El identificador único del producto en el carrito.
cartId (string): El identificador del carrito al que pertenece el producto.
productId (string): El identificador del producto.
quantity (number): La cantidad del producto en el carrito.
createdAt (string): La marca de tiempo de cuándo se añadió el producto al carrito.
updatedAt (string): La marca de tiempo de cuándo se actualizó por última vez el producto en el carrito.
productDetails (object): Un objeto que contiene detalles del producto con las siguientes propiedades:
id (string): El identificador único del producto.
Handle (string): El handle del producto.
Title (string): El título del producto.
Description (string): La descripción del producto.
SKU (string): La unidad de mantenimiento de existencias del producto.
Grams (number): El peso del producto en gramos.
Stock (number): El stock disponible del producto.
Price (number): El precio del producto.
ComparePrice (number): El precio comparativo del producto.
Barcode (string): El código de barras del producto.
category (number): La categoría del producto.
createdBy (string): El creador del producto.
createdAt (string): La marca de tiempo de cuándo se creó el producto.
updatedAt (string): La marca de tiempo de cuándo se actualizó por última vez el producto.
jsonCopiar código[\n {\n \"type\": \"object\",\n \"properties\": {\n \"id\": { \"type\": \"string\" },\n \"cartId\": { \"type\": \"string\" },\n \"productId\": { \"type\": \"string\" },\n \"quantity\": { \"type\": \"number\" },\n \"createdAt\": { \"type\": \"string\" },\n \"updatedAt\": { \"type\": \"string\" },\n \"productDetails\": {\n \"type\": \"object\",\n \"properties\": {\n \"id\": { \"type\": \"string\" },\n \"Handle\": { \"type\": \"string\" },\n \"Title\": { \"type\": \"string\" },\n \"Description\": { \"type\": \"string\" },\n \"SKU\": { \"type\": \"string\" },\n \"Grams\": { \"type\": \"number\" },\n \"Stock\": { \"type\": \"number\" },\n \"Price\": { \"type\": \"number\" },\n \"ComparePrice\": { \"type\": \"number\" },\n \"Barcode\": { \"type\": \"string\" },\n \"category\": { \"type\": \"number\" },\n \"createdBy\": { \"type\": \"string\" },\n \"createdAt\": { \"type\": \"string\" },\n \"updatedAt\": { \"type\": \"string\" }\n }\n }\n }\n }\n]\n\nEste documento proporciona una descripción clara de cómo obtener la lista de productos en un carrito, incluyendo el método, la URL, los encabezados, el cuerpo de la solicitud y la estructura de la respuesta esperada.
\n","urlObject":{"port":"","path":["api","v1","cart","","products"],"host":["http://localhost:9000"],"query":[],"variable":[]}},"response":[],"_postman_id":"5b4c9ecb-0310-4985-bdb5-9364e917b084"},{"name":"Obtener Carrtio de un usuario","id":"70b1f92f-bc79-429e-88f0-90dcf6e6b730","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"jwt eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjEzZmJlNzM5LTdhNjMtNDY2ZS1iZjNkLTU4ZDM5ZDIwNmM0NSIsImVtYWlsIjoibHVmZTAyM0BnbWFpbC5jb20iLCJyb2xlIjoyLCJpYXQiOjE3MTk0MzY4NTgsImV4cCI6MTcyMjAyODg1OH0.V9yvh9GjmRxCvjxFL4WTgzTO-BSDion02zds2NVOlRY"}],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"http://localhost:9000/api/v1/cart/","description":"Este endpoint recupera la lista de productos en un carrito específico identificado por el cartId.
Método: GET
URL: http://localhost:9000:/api/v1/cart//products
Cuerpo de la Solicitud:
Esta solicitud no requiere un cuerpo de solicitud.
La respuesta es un arreglo JSON que contiene objetos con las siguientes propiedades:
\nid (string): El identificador único del producto en el carrito.
cartId (string): El identificador del carrito al que pertenece el producto.
productId (string): El identificador del producto.
quantity (number): La cantidad del producto en el carrito.
createdAt (string): La marca de tiempo de cuándo se añadió el producto al carrito.
updatedAt (string): La marca de tiempo de cuándo se actualizó por última vez el producto en el carrito.
productDetails (object): Un objeto que contiene detalles del producto con las siguientes propiedades:
id (string): El identificador único del producto.
Handle (string): El handle del producto.
Title (string): El título del producto.
Description (string): La descripción del producto.
SKU (string): La unidad de mantenimiento de existencias del producto.
Grams (number): El peso del producto en gramos.
Stock (number): El stock disponible del producto.
Price (number): El precio del producto.
ComparePrice (number): El precio comparativo del producto.
Barcode (string): El código de barras del producto.
category (number): La categoría del producto.
createdBy (string): El creador del producto.
createdAt (string): La marca de tiempo de cuándo se creó el producto.
updatedAt (string): La marca de tiempo de cuándo se actualizó por última vez el producto.
jsonCopiar código[\n {\n \"type\": \"object\",\n \"properties\": {\n \"id\": { \"type\": \"string\" },\n \"cartId\": { \"type\": \"string\" },\n \"productId\": { \"type\": \"string\" },\n \"quantity\": { \"type\": \"number\" },\n \"createdAt\": { \"type\": \"string\" },\n \"updatedAt\": { \"type\": \"string\" },\n \"productDetails\": {\n \"type\": \"object\",\n \"properties\": {\n \"id\": { \"type\": \"string\" },\n \"Handle\": { \"type\": \"string\" },\n \"Title\": { \"type\": \"string\" },\n \"Description\": { \"type\": \"string\" },\n \"SKU\": { \"type\": \"string\" },\n \"Grams\": { \"type\": \"number\" },\n \"Stock\": { \"type\": \"number\" },\n \"Price\": { \"type\": \"number\" },\n \"ComparePrice\": { \"type\": \"number\" },\n \"Barcode\": { \"type\": \"string\" },\n \"category\": { \"type\": \"number\" },\n \"createdBy\": { \"type\": \"string\" },\n \"createdAt\": { \"type\": \"string\" },\n \"updatedAt\": { \"type\": \"string\" }\n }\n }\n }\n }\n]\n\nEste documento proporciona una descripción clara de cómo obtener la lista de productos en un carrito, incluyendo el método, la URL, los encabezados, el cuerpo de la solicitud y la estructura de la respuesta esperada.
\n","urlObject":{"path":["api","v1","cart",""],"host":["http://localhost:9000"],"query":[],"variable":[]}},"response":[],"_postman_id":"70b1f92f-bc79-429e-88f0-90dcf6e6b730"},{"name":"Eliminar Producto del Carrito","id":"dcd980c5-c971-472d-abf5-c4ee045f20be","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"Authorization","value":"jwt "}],"url":"http://localhost:9000:/api/v1/cart/products/d760bc2a-7a92-4736-8877-14c1d8116459","description":"Este endpoint se utiliza para eliminar un producto específico del carrito del usuario.
\nMétodo: DELETE
URL: http://localhost:9000:/api/v1/cart/products/d760bc2a-7a92-4736-8877-14c1d8116459
La respuesta para esta solicitud es un código de estado 204 sin contenido. Según la solicitud del usuario, la respuesta puede documentarse como un esquema JSON.
jsonCopiar código{\n \"type\": \"object\",\n \"properties\": {},\n \"required\": []\n}\n\nStartFragment
\nEste endpoint se utiliza para dejar el carrito de un usuario en blanco
\nMétodo: DELETE
URL: http://localhost:9000:/api/v1/cart/products/:cartItemId
Esta solicitud no requiere un cuerpo de solicitud.
\nLa respuesta es un código de estado 204 sin contenido. Según la solicitud del usuario, la respuesta puede documentarse como un esquema JSON.
jsonCopiar código{\n \"type\": \"object\",\n \"properties\": {},\n \"required\": []\n}\n\nCarpeta asignada para manejar los endpoints relacionados con el carrito de compras
\n","_postman_id":"f05fc3c0-8fcd-485b-b064-14af1420c9bf"},{"name":"Order (Facturas)","item":[{"name":"Crear Order (Factura)","id":"93fae778-512b-438e-9a54-e90dfa9f90e2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"jwt "}],"body":{"mode":"raw","raw":"{\n \"paymentMethod\": \"credit_card[1]\",\n \"shippingAddress\": \"123 Calle Principal, Ciudad, País\"\n}"},"url":"http://localhost:9000:/api/v1/orders","description":"Esta solicitud HTTP POST se utiliza para crear nuevas órdenes en la API. La solicitud debe enviarse a http://localhost:9000:/api/v1/orders.
El cuerpo de la solicitud debe estar en formato raw e incluir los siguientes parámetros:
\npaymentMethod (string): El método de pago para la orden.
shippingAddress (string): La dirección de envío para la orden.
jsonCopiar código{\n \"paymentMethod\": \"tarjeta de crédito\",\n \"shippingAddress\": \"123 Calle Principal, Ciudad, País\"\n}\n\nLa respuesta a esta solicitud contendrá los detalles de la orden recién creada. El formato de la respuesta será en JSON y contendrá los siguientes campos:
\nid (string): El ID único de la orden.
userId (string): El ID del usuario que realizó la orden.
totalPrice (number): El precio total de la orden.
paymentMethod (string): El método de pago utilizado.
shippingAddress (string): La dirección de envío proporcionada.
status (string): El estado de la orden (ej. \"pendiente\", \"completada\").
createdAt (string): La fecha y hora de creación de la orden.
updatedAt (string): La fecha y hora de la última actualización de la orden.
jsonCopiar código{\n \"id\": \"1a2b3c4d\",\n \"userId\": \"13fbe739-7a63-466e-bf3d-58d39d206c45\",\n \"totalPrice\": 150.75,\n \"paymentMethod\": \"tarjeta de crédito\",\n \"shippingAddress\": \"123 Calle Principal, Ciudad, País\",\n \"status\": \"pendiente\",\n \"createdAt\": \"2024-05-16T12:34:56.789Z\",\n \"updatedAt\": \"2024-05-16T12:34:56.789Z\"\n}\n\nValidación de Campos: Asegúrese de validar los campos paymentMethod y shippingAddress en el servidor para evitar datos inválidos.
Autenticación: Esta solicitud debería requerir autenticación para asegurarse de que solo usuarios autenticados puedan crear órdenes.
\nErrores: Maneje adecuadamente los posibles errores, como métodos de pago no soportados o direcciones de envío inválidas, y proporcione mensajes de error claros.
\nCon esta configuración, debería ser capaz de manejar la creación de órdenes de manera eficiente y segura en su sistema.
\n","urlObject":{"port":"","path":["api","v1","orders"],"host":["http://localhost:9000"],"query":[],"variable":[]}},"response":[],"_postman_id":"93fae778-512b-438e-9a54-e90dfa9f90e2"},{"name":"Get Order by ID","id":"5f721441-9da1-4d7c-a94e-5636b5a58f44","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"jwt "}],"url":"http://localhost:9000:/api/v1/orders/74bc6d57-0ec0-43e8-97b4-aa93623c815f","description":"Este endpoint recupera los detalles de una orden específica.
\nMétodo HTTP: GET
URL: http://localhost:9000:/api/v1/orders/74bc6d57-0ec0-43e8-97b4-aa93623c815f
Estado: 200 OK
Content-Type: application/json
jsonCopiar código{\n \"id\": \"74bc6d57-0ec0-43e8-97b4-aa93623c815f\",\n \"userId\": \"13fbe739-7a63-466e-bf3d-58d39d206c45\",\n \"status\": \"pendiente\",\n \"totalPrice\": 150.75,\n \"paymentMethod\": \"tarjeta de crédito\",\n \"paidAt\": \"2024-05-16T13:45:30.789Z\",\n \"shippingAddress\": \"123 Calle Principal, Ciudad, País\",\n \"createdAt\": \"2024-05-16T12:34:56.789Z\",\n \"updatedAt\": \"2024-05-16T12:34:56.789Z\",\n \"orderDetails\": [\n {\n \"id\": \"3e4d6f7b-8a7a-4e8b-b23e-f4d6e4b6a8f7\",\n \"orderId\": \"74bc6d57-0ec0-43e8-97b4-aa93623c815f\",\n \"productId\": \"a1b2c3d4-e5f6-7890-abcd-12345678efgh\",\n \"quantity\": 2,\n \"price\": 75.00,\n \"createdAt\": \"2024-05-16T12:35:00.789Z\",\n \"updatedAt\": \"2024-05-16T12:35:00.789Z\"\n }\n ]\n}\n\nid (string): El ID único de la orden.
userId (string): El ID del usuario que realizó la orden.
status (string): El estado de la orden (ej. \"pendiente\", \"completada\").
totalPrice (number): El precio total de la orden.
paymentMethod (string): El método de pago utilizado.
paidAt (string): La fecha y hora en que se realizó el pago.
shippingAddress (string): La dirección de envío proporcionada.
createdAt (string): La fecha y hora de creación de la orden.
updatedAt (string): La fecha y hora de la última actualización de la orden.
orderDetails (array): Una lista de objetos que contienen los detalles de los productos en la orden, cada uno con los siguientes campos:
id (string): El ID único del detalle de la orden.
orderId (string): El ID de la orden a la que pertenece el detalle.
productId (string): El ID del producto.
quantity (number): La cantidad del producto en la orden.
price (number): El precio del producto.
createdAt (string): La fecha y hora de creación del detalle de la orden.
updatedAt (string): La fecha y hora de la última actualización del detalle de la orden.
Esta configuración proporciona toda la información necesaria para obtener los detalles completos de una orden específica.
\n","urlObject":{"port":"","path":["api","v1","orders","74bc6d57-0ec0-43e8-97b4-aa93623c815f"],"host":["http://localhost:9000"],"query":[],"variable":[]}},"response":[],"_postman_id":"5f721441-9da1-4d7c-a94e-5636b5a58f44"},{"name":"Get All User Orders","id":"e3fea6e2-8e56-4a3a-bbdc-00d101fdf1e2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"jwt "}],"url":"http://localhost:9000:/api/v1/orders","description":"Este endpoint recupera una lista de órdenes.
\nMétodo HTTP: GET
URL: http://localhost:9000:/api/v1/orders
No se requiere un cuerpo de solicitud para esta petición.
\nLa respuesta será un array JSON que contiene objetos de orden con las siguientes propiedades:
\nid (string): El identificador único de la orden.
userId (string): El identificador único del usuario que realizó la orden.
status (string): El estado de la orden.
totalPrice (number): El precio total de la orden.
paymentMethod (string): El método de pago utilizado para la orden.
paidAt (string): La marca de tiempo cuando se pagó la orden.
shippingAddress (string): La dirección de envío de la orden.
createdAt (string): La marca de tiempo cuando se creó la orden.
updatedAt (string): La marca de tiempo cuando se actualizó por última vez la orden.
orderDetails (array): Un array de objetos de detalles de la orden con las siguientes propiedades:
id (string): El identificador único del detalle de la orden.
orderId (string): El identificador único de la orden a la que pertenece el detalle.
productId (string): El identificador único del producto en el detalle de la orden.
quantity (number): La cantidad del producto en el detalle de la orden.
price (number): El precio del producto en el detalle de la orden.
createdAt (string): La marca de tiempo cuando se creó el detalle de la orden.
updatedAt (string): La marca de tiempo cuando se actualizó por última vez el detalle de la orden.
jsonCopiar código[\n {\n \"id\": \"74bc6d57-0ec0-43e8-97b4-aa93623c815f\",\n \"userId\": \"13fbe739-7a63-466e-bf3d-58d39d206c45\",\n \"status\": \"completed\",\n \"totalPrice\": 150.75,\n \"paymentMethod\": \"credit card\",\n \"paidAt\": \"2024-05-16T13:45:30.789Z\",\n \"shippingAddress\": \"123 Main St, City, Country\",\n \"createdAt\": \"2024-05-16T12:34:56.789Z\",\n \"updatedAt\": \"2024-05-16T12:34:56.789Z\",\n \"orderDetails\": [\n {\n \"id\": \"3e4d6f7b-8a7a-4e8b-b23e-f4d6e4b6a8f7\",\n \"orderId\": \"74bc6d57-0ec0-43e8-97b4-aa93623c815f\",\n \"productId\": \"a1b2c3d4-e5f6-7890-abcd-12345678efgh\",\n \"quantity\": 2,\n \"price\": 75.00,\n \"createdAt\": \"2024-05-16T12:35:00.789Z\",\n \"updatedAt\": \"2024-05-16T12:35:00.789Z\"\n }\n ]\n }\n]\n\nEsta respuesta proporciona todos los detalles necesarios sobre las órdenes y sus respectivos productos.
\n","urlObject":{"port":"","path":["api","v1","orders"],"host":["http://localhost:9000"],"query":[],"variable":[]}},"response":[],"_postman_id":"e3fea6e2-8e56-4a3a-bbdc-00d101fdf1e2"},{"name":"Update Order Status","id":"7d26c436-6185-42dc-8718-dee372a085e5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"jwt "}],"body":{"mode":"raw","raw":"{\n \"status\": \"enviado\"\n}"},"url":"http://localhost:9000:/api/v1/orders/74bc6d57-0ec0-43e8-97b4-aa93623c815f/status","description":"Este endpoint permite al cliente actualizar el estado de una orden específica enviando una solicitud HTTP PUT a la URL especificada.
\nMétodo: PUT
URL: http://localhost:9000:/api/v1/orders/:orderId
El cuerpo de la solicitud debe estar en formato JSON crudo e incluir el siguiente parámetro:
\nstatus (string): El estado actualizado de la orden.{\n \"status\": \"enviado\"\n}\n\nTras una ejecución exitosa, el servidor responde con un código de estado 200 y un objeto JSON que contiene un campo message que proporciona información sobre el resultado de la solicitud.
{\n \"message\": \"Estado de la orden actualizado\"\n}\n\nEsta configuración asegura que los estados de las órdenes se puedan actualizar de manera eficiente, proporcionando una retroalimentación clara al cliente.
\n","urlObject":{"port":"","path":["api","v1","orders","74bc6d57-0ec0-43e8-97b4-aa93623c815f","status"],"host":["http://localhost:9000"],"query":[],"variable":[]}},"response":[],"_postman_id":"7d26c436-6185-42dc-8718-dee372a085e5"}],"id":"35eda2dd-f8d6-4529-96eb-3b406b55c66c","_postman_id":"35eda2dd-f8d6-4529-96eb-3b406b55c66c","description":""},{"name":"Informes","item":[{"name":"Obtener los usuarios de Hoy","id":"0a042b3b-bf92-448b-b8cc-b80166d6e3c0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"jwt "}],"url":"http://localhost:9000/api/v1/informs/userstoday","description":"GET http://localhost:9000/api/v1/informs/userstoday
Este endpoint se utiliza para obtener una lista de usuarios que fueron creados en el día actual. Es útil para obtener estadísticas diarias sobre la creación de usuarios.
\nAuthorization: Bearer (Requerido)Ninguno
\nLa respuesta a esta solicitud es un array JSON que contiene la lista de usuarios creados hoy. El esquema de la respuesta es el siguiente:
\n[\n {\n \"id\": \"string\",\n \"firstName\": \"string\",\n \"lastName\": \"string\",\n \"email\": \"string\",\n \"phone\": \"string\",\n \"role\": \"number\",\n \"status\": \"string\",\n \"isVerified\": \"boolean\",\n \"createdAt\": \"string\",\n \"updatedAt\": \"string\"\n }\n]\n\ncurl -X GET \"http://localhost:9000/api/v1/informs/userstoday\" -H \"Authorization: Bearer \"\n\nReemplaza con tu token de autenticación JWT.
Esta ruta requiere autenticación JWT.
\nGET http://localhost:9000/api/v1/informs/usersthismonth
Este endpoint se utiliza para obtener una lista de usuarios que fueron creados en el mes actual. Es útil para obtener estadísticas mensuales sobre la creación de usuarios.
\nAuthorization: Bearer (Requerido)Ninguno
\nLa respuesta a esta solicitud es un array JSON que contiene la lista de usuarios creados en el mes actual. El esquema de la respuesta es el siguiente:
\n[\n {\n \"id\": \"string\",\n \"firstName\": \"string\",\n \"lastName\": \"string\",\n \"email\": \"string\",\n \"phone\": \"string\",\n \"role\": \"number\",\n \"status\": \"string\",\n \"isVerified\": \"boolean\",\n \"createdAt\": \"string\",\n \"updatedAt\": \"string\"\n }\n]\n\ncurl -X GET \"http://localhost:9000/api/v1/informs/usersthismonth\" -H \"Authorization: Bearer \"\n\nReemplaza con tu token de autenticación JWT.
Esta ruta requiere autenticación JWT.
\nGET http://localhost:9000/api/v1/informs/usersbyday/:day
Este endpoint se utiliza para obtener una lista de usuarios que fueron creados en un día específico. Es útil para obtener estadísticas diarias sobre la creación de usuarios.
\nAuthorization: Bearer (Requerido):day (Requerido): El día específico para el cual se desean obtener los usuarios. El formato debe ser YYYY-MM-DD.La respuesta a esta solicitud es un array JSON que contiene la lista de usuarios creados en el día específico. El esquema de la respuesta es el siguiente:
\n[\n {\n \"id\": \"string\",\n \"firstName\": \"string\",\n \"lastName\": \"string\",\n \"email\": \"string\",\n \"phone\": \"string\",\n \"role\": \"number\",\n \"status\": \"string\",\n \"isVerified\": \"boolean\",\n \"createdAt\": \"string\",\n \"updatedAt\": \"string\"\n }\n]\n\ncurl -X GET \"http://localhost:9000/api/v1/informs/usersbyday/2024-05-20\" -H \"Authorization: Bearer \"\n\nReemplaza con tu token de autenticación JWT.
Reemplaza 2024-05-20 con el día específico para el cual deseas obtener los usuarios.
Esta ruta requiere autenticación JWT.
\nFecha específica en formato YYYY-MM-DD.
\n","type":"text/plain"},"type":"any","value":"2024-05-27","key":"day"}]}},"response":[],"_postman_id":"506a05ab-8688-4dff-a340-407816343fbd"},{"name":"Obtener los usuarios de la ultima semana","id":"2004c84a-020a-4606-b612-87761822bf08","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Authorization","value":"jwt "}],"url":"http://localhost:9000/api/v1/informs/userslastweek","description":"GET http://localhost:9000/api/v1/informs/userslastweek
Este endpoint se utiliza para obtener una lista de usuarios que fueron creados durante la semana pasada. Es útil para obtener estadísticas semanales sobre la creación de usuarios.
\nAuthorization: Bearer (Requerido)La respuesta a esta solicitud es un array JSON que contiene la lista de usuarios creados durante la semana pasada. El esquema de la respuesta es el siguiente:
\n[\n {\n \"id\": \"string\",\n \"firstName\": \"string\",\n \"lastName\": \"string\",\n \"email\": \"string\",\n \"phone\": \"string\",\n \"role\": \"number\",\n \"status\": \"string\",\n \"isVerified\": \"boolean\",\n \"createdAt\": \"string\",\n \"updatedAt\": \"string\"\n }\n]\n\ncurl -X GET \"http://localhost:9000/api/v1/informs/userslastweek\" -H \"Authorization: Bearer \"\n\nReemplaza con tu token de autenticación JWT.
Esta ruta requiere autenticación JWT.
\nGET http://localhost:9000/api/v1/informs/usersbymonth/:monthsAgo
Este endpoint se utiliza para obtener una lista de usuarios que fueron creados hace un número específico de meses. El número de meses se pasa como un parámetro en la ruta. No es un rango, solo traerá la data de los usuarios que se crearon en ese mes. Por ejemplo, si estás en enero y le pasas 2 como parámetro, entonces te devolverá los usuarios creados en noviembre y solo noviembre.
\n:monthsAgo (número, requerido): El número de meses atrás desde el mes actual.Authorization: Bearer (Requerido)La respuesta a esta solicitud es un array JSON que contiene la lista de usuarios creados durante el mes especificado. El esquema de la respuesta es el siguiente:
\n[\n {\n \"id\": \"string\",\n \"firstName\": \"string\",\n \"lastName\": \"string\",\n \"email\": \"string\",\n \"phone\": \"string\",\n \"role\": \"number\",\n \"status\": \"string\",\n \"isVerified\": \"boolean\",\n \"createdAt\": \"string\",\n \"updatedAt\": \"string\"\n }\n]\n\ncurl -X GET \"http://localhost:9000/api/v1/informs/usersbymonth/2\" -H \"Authorization: Bearer \"\n\nReemplaza con tu token de autenticación JWT.
Esta ruta requiere autenticación JWT.
\nPor ejemplo, usersbymonth/2 devuelve los usuarios creados hace 2 meses.
GET http://localhost:9000/api/v1/informs/usersbybirthdayrange?startDate=1991-10-31&endDate=1991-10-31
Este endpoint se utiliza para obtener una lista de usuarios que tienen su cumpleaños entre dos fechas específicas.
\nstartDate (string, requerido): La fecha de inicio del rango en formato YYYY-MM-DD.
endDate (string, requerido): La fecha de fin del rango en formato YYYY-MM-DD.
Authorization: Bearer (Requerido)La respuesta a esta solicitud es un array JSON que contiene la lista de usuarios que cumplen años dentro del rango de fechas especificado. El esquema de la respuesta es el siguiente:
\n[\n {\n \"id\": \"string\",\n \"firstName\": \"string\",\n \"lastName\": \"string\",\n \"email\": \"string\",\n \"phone\": \"string\",\n \"birthday\": \"string\",\n \"role\": \"number\",\n \"status\": \"string\",\n \"isVerified\": \"boolean\",\n \"createdAt\": \"string\",\n \"updatedAt\": \"string\"\n }\n]\n\ncurl -X GET \"http://localhost:9000/api/v1/informs/usersbybirthdayrange?startDate=1991-10-31&endDate=1991-10-31\" -H \"Authorization: Bearer \"\n\nReemplaza con tu token de autenticación JWT.
Esta ruta requiere autenticación JWT.
\nPor ejemplo, usersbybirthdayrange?startDate=1991-10-31&endDate=1991-10-31 devuelve los usuarios que cumplen años el 31 de octubre de 1991.
Fecha de inicio del rango (YYYY-MM-DD).
\n","type":"text/plain"},"key":"startDate","value":"1991-10-31"},{"description":{"content":"Fecha de fin del rango (YYYY-MM-DD).
\n","type":"text/plain"},"key":"endDate","value":"1991-10-31"}],"variable":[]}},"response":[],"_postman_id":"47f85001-289e-4296-9678-02fe10ce3600"}],"id":"a626ea9b-e94f-45f3-8852-a6320b87b59b","_postman_id":"a626ea9b-e94f-45f3-8852-a6320b87b59b","description":""},{"name":"Preguntas Frecuentes (FAQ)","item":[],"id":"901bada9-f30f-47f3-b8c8-a803aaac2910","description":"¿Cómo me autentico en la API?
\n¿Cómo creo una lista de favoritos para un usuario?
\n¿Cómo agrego un producto a la lista de favoritos de un usuario?
\n/api/v1/favoritelist/add-product proporcionando el userId y el productId en el cuerpo de la solicitud.¿Cómo obtengo los productos en la lista de favoritos de un usuario?
\n/api/v1/favoritelist/:userId/products donde userId es el ID del usuario.¿Cómo puedo recuperar mi token JWT?
\n/api/v1/auth/login.¿Qué debo hacer si recibo un error 401 Unauthorized?
\nBearer . Si el problema persiste, tu token podría haber expirado y necesitas obtener uno nuevo.¿Cómo elimino un producto de la lista de favoritos de un usuario?
\n/api/v1/favoritelist/remove-product con los parámetros de consulta userId y productId.