Capítulo 10: Creación de una API REST básica con NodeJS y ExpressJS
NodeJS, junto con ExpressJS, proporciona una plataforma sólida para crear API RESTful. En este capítulo, cubriremos los pasos necesarios para crear una API básica desde cero.
1. Instalación de NodeJS y ExpressJS
Para empezar, necesitamos tener NodeJS instalado en nuestro sistema. NodeJS es una plataforma de desarrollo de aplicaciones JavaScript que permite la ejecución de código JavaScript en el lado del servidor. Para instalar NodeJS, puede descargar el instalador desde el sitio web oficial de NodeJS.
Después de instalar NodeJS, necesitamos instalar ExpressJS. Express es un marco de aplicación web Node.js mínimo y flexible que proporciona un sólido conjunto de funciones para aplicaciones web y móviles. Para instalar Express, puede usar npm (Node Package Manager), que se instala automáticamente con NodeJS. Para instalar Express, abra la terminal y escriba el siguiente comando: npm install express
2. Creando la estructura básica del proyecto
Después de instalar NodeJS y Express, el siguiente paso es crear la estructura básica de nuestro proyecto. Primero, cree una nueva carpeta para el proyecto, luego inicie npm para crear un nuevo archivo package.json. El archivo package.json contiene toda la información sobre el proyecto, incluidas las dependencias del proyecto.
Para inicializar npm, abra la terminal, navegue hasta la carpeta del proyecto y escriba el siguiente comando: npm init. Siga las instrucciones que aparecen en pantalla para crear el archivo package.json.
3. Creando el servidor
Con la estructura básica del proyecto implementada, ahora podemos crear nuestro servidor. Para eso, necesitamos crear un nuevo archivo llamado server.js en la raíz de nuestro proyecto. En este archivo, importaremos Express y crearemos una nueva instancia de Express.
A continuación, definamos el puerto en el que nuestro servidor escuchará. Para ello, podemos utilizar el método de escucha de Express. Finalmente, agreguemos middleware para manejar las solicitudes HTTP. El middleware es una función que tiene acceso al objeto de solicitud (req), al objeto de respuesta (res) y al siguiente middleware en la pila de aplicaciones.
4. Creando las rutas
Con el servidor creado, el siguiente paso es crear las rutas para nuestra API. Las rutas definen nuestros puntos finales API, es decir, los puntos de acceso que nuestros clientes API pueden usar para interactuar con nuestra API.
Para crear las rutas, usaremos el método Router de Express. Router es un middleware que le permite definir múltiples rutas en un solo lugar. Para cada ruta podemos definir el método HTTP al que responderá (GET, POST, PUT, DELETE, etc.) y la función que se ejecutará cuando se acceda a la ruta.
5. Probando la API
Después de crear las rutas, podemos probar nuestra API. Para ello podemos utilizar herramientas como Postman o Curl. Estas herramientas le permiten enviar solicitudes HTTP a nuestra API y ver la respuesta que devuelve.
Para probar la API, simplemente inicie el servidor (usando el comando node server.js en la terminal) y luego envíe una solicitud a la ruta que desea probar. Si todo funciona correctamente, deberías ver la respuesta de tu API en la herramienta que estás utilizando para realizar la prueba.
En resumen, crear una API REST básica con NodeJS y ExpressJS implica instalar NodeJS y Express, crear la estructura básica del proyecto, crear el servidor, definir las rutas y probar la API. Si bien este es un proceso básico, proporciona una base sólida para crear API más complejas y potentes.
