¿Cómo levantar sparREST?

Autor: | Última modificación: 21 de noviembre de 2022 | Tiempo de Lectura: 3 minutos
Temas en este post:

sparREST es una herramienta muy útil a la hora de desarrollar proyectos pequeños que requieran de una API local. En este post, te enseñaremos cómo levantar sparREST para que puedas enganchar su API con tus proyectos web.

¿Qué es sparREST?

sparREST es un repositorio que nos permite crear una API REST en local con una serie de endpoints fundamentales para crear un proyecto web. Para ello, este proyecto se basa en el repositorio open source json-server.

Para conocer más sobre esta herramienta, te recomendamos leer nuestro post sobre cómo usar sparREST, donde te explicamos sus distintos componentes y cómo usarlos. Además, te recomendamos leer la documentación oficial en su GitHub. A continuación, te enseñaremos cómo levantar sparREST una vez lo tienes clonado en tu máquina.

¿Cómo levantar sparREST?

Una ves hayas clonado el repositorio en tu máquina, lo primero que deberás hacer para levantar sparREST es ejecutar un npm install sobre el archivo donde lo hayas guardado. A continuación, puedes ver un pantallazo de nuestra terminal cuando ejecutamos este comando.

Primer paso para levantar sparREST
Primer paso para levantar sparREST

Desde KeepCoding te recomendamos instalar y clonar este proyecto en una carpeta distinta al proyecto que estés desarrollando, a pesar de que más tarde lo conectarás con la API creada por sparREST. En este sentido, los dos proyectos quedarán como hermanos. Es decir, estarán a la misma altura dentro de tu terminal.

El comando anterior nos permitirá instalar todas las dependencias que tiene el proyecto sparrest.js. Para revisar las dependencias que se instalan cuando logramos levantar sparREST, puedes dirigirte al archivo package.json, donde verás un listado de ellas. Algunas de las dependencias que encontrarás son bcrypt, cors y json-server.

Una vez ejecutes este npm install, se creará una carpeta llamada nodule_modules, donde verás muchísimas carpetas que permiten que este proyecto se ejecute, en las que se encuentran diversas librerías de las que depende sparREST.

Ahora que tienes instaladas las distintas dependencias del proyecto, deberás ejecutar el comando npm run start para realmente levantar sparREST y su API REST.

Segundo paso para levantar sparREST
Segundo paso para levantar sparREST

La imagen anterior nos dice que sparREST ya está escuchando en el puerto 8000. Ahora, esto puede generarte un error por diversas razones. Puede que por trabajo o por proyectos personales ya tengas algo andando en este puerto. Entonces, verás en tu terminal un error como el siguiente, en el que aparece un mensaje de adress already in use.

¿Cómo levantar sparREST? 1
Error de puerto

Para poder cambiar el puerto donde se crea este proyecto, deberás dirigirte al archivo index.js y revisar la siguiente línea de código (normalmente encontrada en la línea 16):

const PORT = process.env.PORT || 8000;

Entonces, con tan solo cambiar el número del puerto en esta línea, solucionarás el error de dos proyectos en un mismo puerto. Allí podrás poner cualquier número de un puerto que no tengas ocupado. En realidad, puedes poner cualquier número de cuatro dígitos que se te ocurra (ej. 3864), pues la posibilidad de que esté ocupado es muy baja.

Una vez hayas logrado levantar sparREST, verás un archivo db.json. Ten presente que este archivo se creará si antes no existía en el proyecto. Sin embargo, si el archivo con ese nombre ya existe, será respetado.

Por defecto, el archivo db.json que crea sparREST tiene una línea de código como la siguiente:

{«users»: [ ]}

¿Qué es esta línea de código? Pues es un JSON que tiene la clave users y un array vacío como valor. Esta es la mínima expresión de un archivo db.json, que funciona como una base de datos (db = data base). Con este archivo, lo que hará sparREST es levantar una API y persistir lo que le pasemos. Para conocer más sobre este proceso, te recomendamos leer nuestro post sobre crear usuario con JavaScript y sparREST.

¿Qué sigue?

Ahora que sabes cómo levantar sparREST, ¡es el momento perfecto para usar esta herramienta en el desarrollo de tus propias líneas de código! Para seguir aprendiendo sobre el desarrollo y la creación de todo tipo de proyectos, te invitamos a nuestro Desarrollo Web Full Stack Bootcamp, un espacio de formación intensiva donde aprenderás los lenguajes, patrones y herramientas fundamentales para este ejercicio ¡No te lo pierdas y solicita información ahora!

👉 Descubre más del Desarrollo Web Full Stack Bootcamp ¡Descarga el temario!

👉 Prueba el Bootcamp Gratis por una Semana ¡Empieza ahora mismo!

👉 Conoce nuestros otros Bootcamps en Programación y Tecnología

[email protected]

¿Trabajo? Aprende a programar y consíguelo.

¡No te pierdas la próxima edición del Aprende a Programar desde Cero Full Stack Jr. Bootcamp!

 

Prepárate en 4 meses, aprende las últimas tecnologías y consigue trabajo desde ya. 

 

Solo en España hay más de 120.400 puestos tech sin cubrir, y con un sueldo 11.000€ por encima de la media nacional. ¡Es tu momento!

 

🗓️ Próxima edición: 13 de febrero

 

Reserva tu plaza descubre las becas disponibles.

¿Sabías que hay más de 40.000 vacantes para desarrolladores web sin cubrir en España? 

En KeepCoding llevamos desde 2012 guiando personas como tú a áreas de alta empleabilidad y alto potencial de crecimiento en IT con formación de máxima calidad.

 

Porque creemos que un buen trabajo es fuente de libertad, independencia, crecimiento y eso ¡cambia historias de vida!


¡Da el primer paso!