{"info":{"_postman_id":"95e085f0-7279-4589-b64f-5de812bc21a1","name":"API Vivero 🪴","description":"

🪴 API Vivero – Sistema de gestión para viveros

La API Vivero es un proyecto diseñado para gestionar de forma eficiente la información de un vivero, incluyendo usuarios, clientes, plantas y ventas.

Permite realizar operaciones completas de registro, autenticación, administración de productos y control de ventas, simulando el flujo real de una aplicación de gestión comercial.

Esta API está pensada para pruebas y desarrollo, utilizando endpoints seguros y estructurados bajo buenas prácticas RESTful. Ideal para ensayar autenticación, manejo de tokens y relaciones entre entidades.

⚙️ Características principales

🧩 Estructura RESTful
\n
🔐 Autenticación mediante JWT (Bearer Token)
\n
📦 CRUD completo para usuarios, plantas, clientes y ventas
\n
🧾 Formato de datos JSON
\n
🚀 Desarrollada con Node.js + Express
\n
🔐 Servidor seguro
\n

🔐 Autenticación

Todos los endpoints (excepto el registro y login) requieren un token JWT válido.
El token debe enviarse en el encabezado de cada solicitud:

Authorization: Bearer

🔐 Módulo de Usuarios

Gestión de usuarios y control de acceso al sistema.

Registro de nuevos usuarios.
\n
Inicio de sesión (login) y obtención de token JWT.
\n

Endpoints:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Método	Ruta	Descripción
POST	`/auth/register`	Registrar nuevo usuario con contraseña hasheada
POST	`/auth/login`	Iniciar sesión y obtener token JWT

Ejemplo de creación:

{

\"username\": \"Florencia\",

\"password\": \"contraseña2025\"

}

🌿 Módulo de Plantas

Permite administrar el inventario de plantas del vivero:

Crear nuevas plantas.
\n
Actualizar información existente por ID.
\n
Buscar planta por ID.
\n
Listar todas las plantas disponibles.
\n
Eliminar registros de plantas por ID.
\n

Endpoints:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Método	Ruta	Descripción
POST	`/plants`	Crear nueva planta
GET	`/plants`	Listar todas las plantas
GET	`/plants/:id`	Obtener planta por ID
PUT	`/plants/:id`	Actualizar datos de una planta
DELETE	`/plants/:id`	Eliminar planta

Ejemplo de creación:

{

\"name\": \"Monstera Deliciosa\",

\"species\": \"Monstera deliciosa\",

\"price\": 2500,

\"stock\": 10

}

👥 Módulo de Clientes

Gestión de los clientes asociados a las ventas del vivero, permite:

Alta de nuevos clientes.
\n
Listar clientes registrados.
\n
Búsqueda de clientes por ID.
\n
Edición de datos por ID.
\n
Eliminación de clientes.
\n

Endpoints:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Método	Ruta	Descripción
POST	`/clients`	Crear cliente
GET	`/clients`	Listar clientes
GET	`/clients/:id`	Obtener cliente por ID
PUT	`/clients/:id`	Modificar cliente
DELETE	`/clients/:id`	Eliminar cliente

Ejemplo de creación:

{

\"name\": \"Alejandra\",

\"email\": \"alejandra@gmail.com\",

\"phone\": 1152635700

}

💰 Módulo de Ventas

Gestión de las ventas del vivero.
Cada venta se asocia a un cliente y a una o más plantas, registrando detalles como el total, estado y fecha, permite:

Registrar una venta asociando cliente y planta(s).
\n
Consultar ventas realizadas.
\n
Consultar una venta en especifico por ID.
\n
Actualizar el estado de ventas. (pendiente, pagado , o entregado)
\n
Eliminar operaciones por ID.
\n

Endpoints:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Método	Ruta	Descripción
POST	`/sales`	Registrar una nueva venta
GET	`/sales`	Listar todas las ventas
GET	`/sales/:id`	Consultar una venta por ID
PUT	`/sales/:id`	Actualizar estado de la venta
DELETE	`/sales/:id`	Eliminar venta por ID

Ejemplo de creación:

{
\"clientId\": \"9634f5ff-351d-471f-90ec-0a037c39cf22\",
\"items\": [
{

\"plantId\": \"4c7a5199-2e55-482c-b549-cd5944c4f021\",
\"name\": \"Monstera Deliciosa\",
\"species\": \"Monstera deliciosa\",
\"quantity\": 1,
\"price\": 2500
}

],
\"total\": 1200,
\"status\": \"pendiente\"
}

🏠 Ruta raíz

Ruta principal del servidor utilizada para verificar el estado de la API.

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Método	Ruta	Descripción
GET	`/`	Devuelve mensaje de bienvenida o estado del servidor

🧾 Códigos de estado comunes

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Código	Significado
200	OK
201	Creado
400	Solicitud inválida
401	No autorizado
404	No encontrado
500	Error interno del servidor

🧠 Tecnologías utilizadas

Node.js – Entorno de ejecución
\n
Express – Framework para APIs
\n
MongoDB – Base de datos NoSQL
\n
Mongoose – Modelado de datos para MongoDB
\n
JSON Web Token (JWT) – Autenticación
\n
bcryptjs – Encriptación de contraseñas
\n
express-validator – Validación de datos
\n
dotenv – Manejo de variables de entorno
\n
nodemon – Reinicio automático del servidor en desarrollo
\n
Helmet - Header de seguridad para ocultar huellas, para prevenir inyecciones y para el control de Contenido
\n
Rate Limiting - Para evitas ataques de fuerza bruta y proteger tus recursos
\n

👩‍💻 Desarrollado por

Mary Lezama
Nazarena Contreras

📍 Ciudad Autónoma de Buenos Aires, Argentina
💬 Proyecto académico Ada ITW — Módulo 4, API Vivero

🌱 \"Una planta bien cuidada crece fuerte; una API bien documentada también.\"

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"47327494","collectionId":"95e085f0-7279-4589-b64f-5de812bc21a1","publishedId":"2sB3QNpTcK","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-10-15T20:26:10.000Z"},"item":[{"name":"🔐 Módulo de Usuarios","item":[{"name":"Registro de nuevos usuarios","id":"19d072ea-2353-4a48-9e15-a1e146fe5063","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"username\": \"Florencia_mary\",\r\n \"password\": \"15-florencia25\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:3000/auth/register","urlObject":{"protocol":"http","port":"3000","path":["auth","register"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"19d072ea-2353-4a48-9e15-a1e146fe5063"},{"name":"Login y obtención de token JWT","id":"5e64d3a0-365f-4bb0-aadc-3f65aecbed96","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"username\": \"Florencia_mary\",\r\n \"password\": \"15-florencia25\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:3000/auth/login","urlObject":{"protocol":"http","port":"3000","path":["auth","login"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"5e64d3a0-365f-4bb0-aadc-3f65aecbed96"}],"id":"65985420-3826-4852-8b89-aa8777d3dc3b","_postman_id":"65985420-3826-4852-8b89-aa8777d3dc3b","description":""},{"name":"🌿 Módulo de Plantas","item":[{"name":"Crear nuevas plantas","id":"0c7c8275-8789-45dd-ad5d-2278938d7754","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"name\": \"para borrar\",\r\n \"species\": \"arboleada deiciosa\",\r\n \"price\": 2500,\r\n \"stock\": 10\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:3000/plants","urlObject":{"protocol":"http","port":"3000","path":["plants"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"0c7c8275-8789-45dd-ad5d-2278938d7754"},{"name":"Listar todas las plantas disponibles","id":"590601c5-fc15-4b43-97dc-3512726751c0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"http://localhost:3000/plants","urlObject":{"protocol":"http","port":"3000","path":["plants"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"590601c5-fc15-4b43-97dc-3512726751c0"},{"name":"Buscar planta por ID","id":"e4ba564d-e8ae-4d47-8276-40984b647675","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n \"name\": \"prueba\",\r\n \"species\": \"Lavandula angustifolia\",\r\n \"price\": 1200,\r\n \"stock\": 15\r\n}"},"url":"http://localhost:3000/plants/69bad8088905b18382afe2ff","urlObject":{"protocol":"http","port":"3000","path":["plants","69bad8088905b18382afe2ff"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"e4ba564d-e8ae-4d47-8276-40984b647675"},{"name":"Actualizar información existente por ID","id":"20d57251-40e0-42b3-9720-dfaebb04c825","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"name\": \"matilda\",\r\n \"species\": \"arboleada deiciosa\",\r\n \"price\": 800000,\r\n \"stock\": 10\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:3000/plants/69bad8ab8905b18382afe301","urlObject":{"protocol":"http","port":"3000","path":["plants","69bad8ab8905b18382afe301"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"20d57251-40e0-42b3-9720-dfaebb04c825"},{"name":"Eliminar registros de plantas por ID","id":"3a11cd15-e52b-49f4-bea2-2b3c4bfcf4b9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"DELETE","header":[],"body":{"mode":"raw","raw":"{\r\n \"name\": \"para borrar\",\r\n \"species\": \"arboleada deiciosa\",\r\n \"price\": 2500,\r\n \"stock\": 10\r\n}"},"url":"http://localhost:3000/plants/69badb412bee612a5a63fca7","urlObject":{"protocol":"http","port":"3000","path":["plants","69badb412bee612a5a63fca7"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"3a11cd15-e52b-49f4-bea2-2b3c4bfcf4b9"}],"id":"95e5d9f0-6268-4379-8e01-4703f3b37625","_postman_id":"95e5d9f0-6268-4379-8e01-4703f3b37625","description":""},{"name":"👥 Módulo de Clientes","item":[{"name":"Alta de nuevos clientes","id":"5794563e-4f7d-4b79-a32e-ae0e54dfbe48","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"name\": \"cliente nuevo 2\",\r\n \"email\": \"eliminar2@gmail.com\",\r\n \"phone\": 123456785\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:3000/clients","urlObject":{"protocol":"http","port":"3000","path":["clients"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"5794563e-4f7d-4b79-a32e-ae0e54dfbe48"},{"name":"Listar clientes","id":"42a10623-944f-4674-8f46-2118db4d7b96","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"http://localhost:3000/clients","urlObject":{"protocol":"http","port":"3000","path":["clients"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"42a10623-944f-4674-8f46-2118db4d7b96"},{"name":"Búsqueda de clientes por ID","id":"f91ccf15-3ad5-489d-95ca-388d8365301e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"body":{"mode":"raw","raw":"{\r\n \"name\": \"cliente nuevo 2\",\r\n \"email\": \"eliminar2@gmail.com\",\r\n \"phone\": 123456785\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:3000/clients/69badcd52bee612a5a63fcb0","urlObject":{"protocol":"http","port":"3000","path":["clients","69badcd52bee612a5a63fcb0"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"f91ccf15-3ad5-489d-95ca-388d8365301e"},{"name":"Edición de datos por ID","id":"35359790-7176-4580-8f94-83fea5c6e627","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"name\": \"cliente nueeeeeeeeevo 2\",\r\n \"email\": \"eliminar2@gmail.com\",\r\n \"phone\": 123456785\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:3000/clients/69badcd52bee612a5a63fcb0","urlObject":{"protocol":"http","port":"3000","path":["clients","69badcd52bee612a5a63fcb0"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"35359790-7176-4580-8f94-83fea5c6e627"},{"name":"Eliminación de clientes","id":"8e2b30db-74e9-4c30-beea-15d7cf65205c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"DELETE","header":[],"url":"http://localhost:3000/clients/69badcd52bee612a5a63fcb0","urlObject":{"protocol":"http","port":"3000","path":["clients","69badcd52bee612a5a63fcb0"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"8e2b30db-74e9-4c30-beea-15d7cf65205c"}],"id":"35fe68df-0d7e-482d-83ba-17ff42d3572e","_postman_id":"35fe68df-0d7e-482d-83ba-17ff42d3572e","description":""},{"name":"💰 Módulo de Ventas","item":[{"name":"Registrar una venta asociando cliente y planta(s)","id":"65e8bb29-1ae6-40bd-b07b-2f76d36d2674","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"clientId\": \"69badcba2bee612a5a63fcac\",\r\n \"items\": [\r\n {\r\n \"plantId\": \"69bad8ab8905b18382afe301\",\r\n \"name\": \"matilda\",\r\n \"species\": \"arboleada deiciosa\",\r\n \"quantity\": 1,\r\n \"price\": 800000\r\n }\r\n ],\r\n \"total\": 800000,\r\n \"status\": \"pendiente\"\r\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:3000/sales","urlObject":{"protocol":"http","port":"3000","path":["sales"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"65e8bb29-1ae6-40bd-b07b-2f76d36d2674"},{"name":"Consultar ventas realizadas","id":"0a7f4963-0735-4e42-84df-b8d031a12bfb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"http://localhost:3000/sales","urlObject":{"protocol":"http","port":"3000","path":["sales"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"0a7f4963-0735-4e42-84df-b8d031a12bfb"},{"name":"Consultar una venta en especifico por ID","id":"e0dbda79-0073-42eb-8390-e035f7a3d50e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"GET","header":[],"url":"http://localhost:3000/sales/69bae2042bee612a5a63fcbb","urlObject":{"protocol":"http","port":"3000","path":["sales","69bae2042bee612a5a63fcbb"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"e0dbda79-0073-42eb-8390-e035f7a3d50e"},{"name":"Actualizar el estado de ventas por ID","id":"bddb3fc6-3be3-4623-a9fa-6be11348fd9c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\r\n \"id\": \"0222e757-83c6-4314-a7da-4445e6c05aff\",\r\n \"date\": \"15/10/2025, 07:24:22 p. m.\",\r\n \"clientId\": \"9634f5ff-351d-471f-90ec-0a037c39cf22\",\r\n \"items\": [\r\n {\r\n \"plantId\": \"4c7a5199-2e55-482c-b549-cd5944c4f021\",\r\n \"quantity\": 1,\r\n \"price\": 2500\r\n }\r\n ],\r\n \"total\": 2500,\r\n \"status\": \"entregado\",\r\n \"createdAt\": \"2025-10-15T22:24:23.025Z\",\r\n \"updatedAt\": \"2025-10-15T22:28:38.548Z\"\r\n }","options":{"raw":{"language":"json"}}},"url":"http://localhost:3000/sales/69bae2042bee612a5a63fcbb/status","urlObject":{"protocol":"http","port":"3000","path":["sales","69bae2042bee612a5a63fcbb","status"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"bddb3fc6-3be3-4623-a9fa-6be11348fd9c"},{"name":"Eliminar operaciones por ID","id":"832d88c0-4042-48ad-8440-ee0be5b36162","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"DELETE","header":[],"url":"http://localhost:3000/sales/69bae2042bee612a5a63fcbb","urlObject":{"protocol":"http","port":"3000","path":["sales","69bae2042bee612a5a63fcbb"],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"832d88c0-4042-48ad-8440-ee0be5b36162"}],"id":"2f90c66b-1237-4005-bb3e-2353b61dbd5f","_postman_id":"2f90c66b-1237-4005-bb3e-2353b61dbd5f","description":""},{"name":"Bienvenida a la API Vivero","id":"7c45a6ee-656f-443e-bd37-720b5ab25364","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:3000/","urlObject":{"protocol":"http","port":"3000","path":[""],"host":["localhost"],"query":[],"variable":[]}},"response":[],"_postman_id":"7c45a6ee-656f-443e-bd37-720b5ab25364"}]}