Para poder probar nuestra API de forma más productiva vamos a tener que usar algún cliente de APIs que nos permita hacer las pruebas de funcionamiento de lo que estás construyendo, los dos clientes más famosos son Insomnia y Postman y vas a necesitar de alguno de ellos para ir probando cada característica que vamos a ir construyendo en nuestro servicio de Platzi Store.
Insomnia
Como cliente para probar APIs tiene grandes características, destaca principalmente por una interfaz limpia y sencilla, pero a la vez potente, en donde puede configurar ambientes, exportar e importar, gran soporte con GraphQL, etc. Insomnia será el que vamos a usar en este curso 🙂
Instalación
La instalación es sencilla, solo tienes que ingresar a https://insomnia.rest/download y descargar el instalador. Una vez esté descargado lo ejecutas y sigues los pasos de la instalación; en caso de Windows descarga un archivo .exe, en caso de Mac descarga un .dmg, y finalmente, en caso de Ubuntu descargas el .deb.
Postman
Es uno de los más usados y legendariamente nos ha acompañado por mucho tiempo, además cuenta con características similares a Insomnia como: exportar e importar, ambientes, entornos, y provee una API para hacer testing muy potente.
Instalación Windows y Mac
La instalación es sencilla solo tienes que ingresar a https://www.postman.com/downloads/
y descargar el instalador, una vez esté descargado lo ejecutas y sigues los pasos de la instalación, en caso de Windows descarga un archivo .exe y en caso de Mac descargas un archivo comprimido lo descomprimes y ahí sigues el proceso.
Muchas gracias, que gran aporte, lo probaré a ver que onda.
Gracias, buen aporte.
Para instalar postman en ubuntu usé el comando snap install postman, por si a alguien le sirve :D
me sale este error
kevin@DESKTOP-D4437LL:~$ snap install postman
error: cannot communicate with server: Post dial unix /run/snapd.socket: connect: no such file or directory
También se puede usar curl desde la consola para hacer peticiones http
Esa no me la sabia :0
Correcto, es una excelente opción!
Yo he estado utilizando una extensión de VS code que sirve igual que postman se llama thunder client, lo bueno es que no tiene que salir del edictor.
Aca hay un video de como se usa y realizando algunas pruebas
https://www.youtube.com/watch?v=fi8-oz0AQGE&t=341s
Postman es de las mejores y mas completas herramientas, a diferencia de algun plugin o extension no solo sirve como cliente REST tambien puede generar documentacion, realizar API tests automatizados, trabajar de forma colaborativa/organizada ya de un modo mas pro.
Yo uso Thunder Client, es bastante bueno, ya que no tengo que salir de VSC, sin mencionar que puedo crear carpetas, exportarlas/adjuntarlas a mi proyecto por si desean hacer test otras personas.
En Ubuntu le dan en descargar el archivo, y lo instalan de dos formas:
Click derecho instalar.
En consola: sudo dpkg -i Insomnia.Core-2021.5.3.deb
PARA UBUNTU
Descargar el paquete .deb desde
Una vez descargado abrir una terminal en la carpeta donde esta el archivo, para abrirla simplemente click derecho y "abrir en una terminal".
Ahora escribir el comando sudo dkpg -i Insomnia.Core-8.4.5.deb
Si la misma versin que yo, con ese comando funcionara, sino, simplemente escribes el nombre del paquete .deb descargado, ya sabes el comando sudo dpkg -i "nombre del paquete"
Cuidado con el orden de las letras en el tercer punto !!! es "dpkg" y no "dkpg"
gracias por la correcion
les recomiendo mucho una extencion que se llama RAPIDAPI para vs, con eso pueden hacer las pruebas sin salirse del editor
Postman
Insomnia
Thunder Client for VS Code
Buenas gente para aquellos que vengan de cursos previos y hayan establecido un entorno de desarollo en WSL y tengan problemas en los comandos o no encuentren un paso a paso sencillo les dejo la forma en la que yo instale para mantener todas nuestras utilidades dentro del mismo ecosistema:
1- Actualizar su sistema por terminal con el siguiente comando:
sudo apt update -y && sudo apt upgrade -y
2- Instalan esto para poder acceder a repositorios via HTTPS:
sudo apt install apt-transport-https -y
3- Añaden el repositorio de Insomnia con este comando:
echo "deb [trusted=yes arch=amd64] https://download.konghq.com/insomnia-ubuntu/ default all" \
| sudo tee -a /etc/apt/sources.list.d/insomnia.list
4- Actualizan las lista apt nuevamente:
sudo apt update
7- Instalan Insomnia:
sudo apt install insomnia
Y luego para acceder tipean insomnia en la terminal, van a ver algo como esto:
Aclaro que no tengo un gran manejo de WSL ni de Ubuntu pero fue a la conclusion mas solida que llegue contrastando distintas fuentes y pasando cada prompt de la terminal por chatGPT para corroborar que no haya nada fuera de lugar.
Respecto al porqué snapd no funciona en WSL esto lo que me respondio chatGPT:
"El error que estás viendo:
System has not been booted with systemd as init system(PID1).Can't operate.Failed to connect to bus:Host is down
indica que estás intentando ejecutar un comando que requiere systemd en un sistema que no está utilizando systemd como su sistema init (PID 1). Systemd es un sistema init comúnmente utilizado en muchas distribuciones de Linux, pero en algunos casos, como en WSL, no se utiliza.
En WSL, no se ejecuta systemd como init system, sino que se utiliza un mecanismo de inicialización más ligero y adaptado a la estructura de WSL.
El error que estás viendo es esperado en WSL y no debería afectar el funcionamiento general de tu distribución de Linux dentro de WSL.
En cuanto al problema original que mencionaste sobre la comunicación con snapd, dado que en WSL no se ejecuta systemd, la comunicación con snapd a través de systemd no es posible.
Si deseas instalar paquetes Snap en WSL, puedes utilizar el método clásico para instalarlos siguiendo las instrucciones proporcionadas por los desarrolladores de los paquetes. Por ejemplo, para instalar Insomnia, puedes seguir los pasos proporcionados por Insomnia en su documentación oficial.
Recuerda que en WSL, aunque no se admita completamente la funcionalidad de snapd, aún puedes instalar y utilizar aplicaciones a través de otros métodos y administradores de paquetes en Linux, como apt o apt-get."
Para mi gusto Postman es mejor ya que te ayuda a generar documentacion de la api forme vas construyendo la misma y tambien puedes agregar documentacion escrita por ti mismo, esto ayuda mucho al fronend.
