Cómo probar una API REST usando Hoppscotch sin instalar ningún programa

Si te dedicas al desarrollo de software, sabrás que dejar que una API llegue a producción sin haberla pasado por el aro es jugar a la ruleta rusa con tu sistema. Por suerte, es posible probar una API REST usando Hoppscotch. Y es que verificar el comportamiento de los endpoints es la única forma de evitar que un cambio insignificante en el código tumbe toda la plataforma en el peor momento posible.

En este sentido, el testing de APIs no es un capricho para los perfeccionistas, sino una línea de defensa fundamental. Al no disponer de una interfaz gráfica donde hacer clic, nos movemos en la capa de mensajes, donde un simple error en un JSON o un código de estado inesperado pueden generar un caos absoluto. Por suerte, existen herramientas que nos facilitan la vida, y hoy vamos a centrarnos en una de las más potentes y libres: Hoppscotch.

¿Qué es Hoppscotch y por qué deberías darle una oportunidad?

 

Hoppscotch nació como una alternativa fresca y abierta (originalmente llamada Postwoman) para quienes buscaban huir de las restricciones y los muros de pago de herramientas como Postman. Es una plataforma de desarrollo y testing de APIs totalmente open source que se puede ejecutar directamente desde el navegador, sin necesidad de registrarse para el uso local, aunque también ofrece aplicaciones de escritorio para Windows, Mac y Linux.

Lo que hace que esta herramienta destaque es su enfoque en la soberanía de los datos. Mientras que otros clientes te obligan a subir todo a la nube, Hoppscotch prioriza el almacenamiento local por defecto. Además, es extremadamente versátil, ya que no se limita solo a REST, sino que incluye soporte nativo para GraphQL, WebSockets, MQTT y Server-Sent Events, convirtiéndola en una navaja suiza para cualquier desarrollador.

Si vienes de Postman o Insomnia, la transición es sencillísima gracias a que permite importar colecciones con un solo clic. No tienes que empezar de cero; simplemente exportas tu JSON v2.1 y lo subes a Hoppscotch para seguir donde lo dejaste, pero disfrutando de una herramienta mucho más ligera y sin el miedo a que mañana te cobren una suscripción prohibitiva por funciones básicas.

Fundamentos del Testing de APIs: No todo es el «camino feliz»

A menudo cometemos el error de testear solo que la API hace lo que queremos cuando todo va bien, lo que se conoce como el «happy path». Sin embargo, el verdadero valor del testing reside en provocar errores a propósito. Debes validar qué pasa cuando envías datos corruptos, tokens caducados o campos obligatorios vacíos. Si tu API no responde con un error 400 coherente en esos casos, tienes un problema de seguridad o de robustez.

Para hacer esto bien, es vital dominar los métodos HTTP. El método GET se usa para recuperar recursos y debe devolver un 200 OK o un 404 si el recurso no existe. El POST sirve para crear y debería responder con un 201 Created. Por otro lado, PUT y PATCH se encargan de las actualizaciones (uno reemplaza todo y el otro solo partes), mientras que DELETE elimina la información, devolviendo normalmente un 204 No Content.

Otro concepto clave es el encadenamiento de peticiones. En la vida real, un usuario no hace una llamada aislada. Primero se loguea (POST), obtiene un token, usa ese token para obtener su perfil (GET) y luego actualiza sus datos (PUT). Hoppscotch permite automatizar este flujo capturando la respuesta de una llamada y guardándola en una variable de entorno para usarla en la siguiente.

 

Guía práctica para probar una API REST usando Hoppscotch

Para empezar a darle caña a tu API, el proceso es muy intuitivo. Solo tienes que elegir el método HTTP, introducir la URL del endpoint y añadir los cabeceras (headers) o el cuerpo (body) en formato JSON si es necesario. Una vez hecho esto, al pulsar «Send», recibirás la respuesta del servidor con el código de estado, el tiempo de respuesta y la carga útil.

Para no volverte loco con URLs repetitivas, utiliza los Entornos y Variables. Puedes crear un entorno de «Desarrollo», uno de «Staging» y otro de «Producción». De este modo, solo cambias la variable <code-base_url y todas tus peticiones se actualizarán automáticamente sin tener que editarlas una a una.

Si quieres subir de nivel a la hora de probar una API REST usando Hoppscotch, dirígete a la pestaña de Tests. Aquí puedes escribir pequeños scripts en JavaScript utilizando el framework de Hoppscotch (pw). Por ejemplo, puedes programar una validación para que la prueba falle si el status no es 200 o si el cuerpo de la respuesta no contiene un campo de email válido. Esto convierte una prueba manual en una verificación automatizada.

Automatización, CI/CD y el ecosistema de herramientas

 

Ejecutar pruebas a mano cada vez que cambias una coma en el código es agotador y propenso a errores. Aquí es donde entra el Hoppscotch CLI. Al instalarlo vía npm, puedes ejecutar tus colecciones de tests directamente desde la terminal. Esto es oro puro para integrarlo en GitHub Actions o GitLab CI, asegurando que ningún commit rompa el sistema antes de llegar a producción, evitando situaciones similares a cuando la automatización falla en Zapier.

En el mercado existen otras opciones interesantes. Buenas alternativas a probar una API REST usando Hoppscotch. Postman es el gigante con la comunidad más grande, pero su creciente dependencia de la nube puede asustar. Insomnia es una alternativa equilibrada y elegante, mientras que Thunder Client es genial si no quieres salir de VS Code. Para los amantes de la terminal, HTTPie ofrece una sintaxis expresiva y colorida que es un placer usar.

No obstante, para quienes buscan control total y gratuidad, Hoppscotch gana la partida. Incluso permite el auto-alojamiento mediante Docker, lo que significa que tu empresa puede tener su propia instancia de la herramienta sin que los datos salgan jamás de sus servidores, garantizando una privacidad absoluta.

El éxito en el desarrollo de APIs radica en no confiar ciegamente en que el código funciona. Implementar un flujo donde se definan contratos claros, se prueben casos de error y se automatice la ejecución en el pipeline de despliegue es lo que diferencia a un proyecto amateur de uno profesional. Al adoptar herramientas como Hoppscotch, no solo optimizas el tiempo de desarrollo, sino que construyes un software resiliente y seguro que puede escalar sin miedo a desplomarse por un descuido.