API-delilah-resto

Proyecto de Acamica para crear una API Resfull con Node.js, Express y SQL

API RESTFULL para el proyecto final de Acámica. API Delilah Restó permite crear usuarios para hacer pedidos al resaturante, de igual forma permite que un usuario administrador pueda ejecutar el CRUD completo de la API.

Tecnologías utilizadas en el proyecto

Node.js
Express
MySQL
Sequelize
JsonWebToken
Swagger
Nodemon7. Postman

Instalación e inicializacion del proyecto

1 - Clonar o descargar el proyecto:

Clonar el repositorio desde el siguiente link. --> http://https://github.com/andresmorenoj/API-delilah-resto

En tu consola o terminal ejecutar:

Posicionate en la carpeta o directorio donde quieres clonar el proyecto. Luego desde la consola ejecuta el comando:

git clone https://github.com/andresmorenoj/API-delilah-resto

Esto clonará todo el contenido del repositorio

Ahora instala las dependencias:

Para instalar las dependencias solo debes ejecutar desde tu terminal o consola el siguiente comando.

npm install

Es tiempo de importar la base de datos

Abre el programa XAMPP o MAMP

Si no tienes ninguno de estos programas, a continuación te dejo los links correspondientes para que los descargues es instales.

Links de desdecarga:

	XAMPP: https://www.apachefriends.org/es/index.html
	MAMP: https://www.mamp.info/en/windows/

Inicializar los servicios de Apache y MySQL
Una vez iniciados los servicios, podemos ingresar a la página de phpMyAdmin donde importaremos nuestra base de datos.
En phpMyAdmin crea una nueva base de datos con el nombre de tu preferencia.
A continuación vas a seleccionar la opción de importar en phpMyAdmin y vas a buscar el archivo dbDelilahResto.sql localizado en el directorio base_de_datos. Este directorio se debió haber descargado cuando se clonó el proyecto, por lo cual debe estar en la carpeta raíz de tu proyecto.
Una vez importada la base de datos, procedemos a configurar nuestro servidor.
1. En los directorios del proyecto (routes y middlewares) hay varios archivos de JavaScript que corresponden a las rutas y middlewares utilizados para realizar las peticiones a la API. Dentro de cada uno de esos archivos de JavaScript vas a identificar la línea de código que sea igual a esta: const sequelize = new Sequelize('mysql://root:root@127.0.0.1:8889/Delilah_Resto') Por lo general esa línea de código siempre va a estar en las primeras líneas de cada archivo.
2. Ahora que ya identificaste la línea de código que te indiqué, deberás reemplazar la información en ella por la de tu servidor, es decir, donde dice 127.0.0.1:8889 deberás reemplazarlo por la dirección IP y puerto que te da XAMPP o MAMP cuando los ejecutas, en la mayoria de los casos la IP es igual a como se muestra en el archivo o puede ser localhost. Luego al final de la línea de código aparece Delilah_Resto el cual corresponde al nombre de la base de datos. Si el nombre que le pusiste a tu base de datos en los pasos anteriores es diferente al del nombre que aparece por defecto, deberás cambiar el nombre en la línea de código por el que pusiste en tu base de datos.

Ahora iniciemos nuestro servidor

En la terminal o consola ejecuta el siguiente comando: npm run dev Este comando iniciará el servidor en el puerto 3000, si por algun motivo te sale un error, tal vez sea porque tienes el puerto 3000 ocupado en otro proceso por lo cual te recomiendo lo siguiente:

Termina el proceso que tienes ejecutando actualmente en el puerto 3000 para que lo puedas utilizar en el proyecto.
Si no puedes terminar con ese proceso, entonces abre el archivo api.js localizado en el directorio raíz del proyecto, luego ubica la línea de código que dice const PORT = process.env.PORT || 3000 y cambia el 3000 por 4000 o cualquier otro puerto que tengas disponible pero que no sea el mismo del de la base de datos.

Documentación de los Endpoints

Ahora que nuestro servidor de Node.js esta corriendo y la base de datos esta creada y conectada a nuestro servidor, es hora de testear nuestros endpoints y hacer peticiones a nuestra API.

Para ello, dirigete al siguiente enlace donde encontrarás la documentación sobre cómo hacer las peticiones tanto para un cliente como para el administrador.

Link de la documentación en Swagger --> Documentación oficial de la API

Nota:

Utiliza postman para hacer las peticiones.

andresmorenoj / API-delilah-resto