Alejandría

Busca en Alejandría

Herramientas

Hoppscotch

Cliente ligero para explorar, probar y compartir peticiones HTTP, GraphQL y WebSocket.

01

En pocas palabras

Cliente ligero para explorar, probar y compartir peticiones HTTP, GraphQL y WebSocket.

Qué problema resuelve

Depuración manual de APIs y ejemplos dispersos difíciles de reproducir.

Cuándo utilizarlo

Desarrollo y soporte de APIs. Ejemplo: reproducir una petición con cabeceras y variables compartidas.

02

De la idea a la práctica

Funcionamiento, ejemplos y decisiones para pasar al siguiente nivel.

En el Radar compartido: Trial (valoración de la edición aportada).

Cómo funciona

Organiza solicitudes y entornos en una interfaz de trabajo con opciones de clientes y autoalojamiento. Facilita experimentar con endpoints antes de integrarlos en código.

Ejemplo de uso

Crear una colección de autenticación y consulta de pedidos con base URL variable. Compartir la definición y proporcionar las credenciales por un canal separado.

Clientes disponibles

Cliente Uso
Web (PWA) Sin instalación; las peticiones a redes internas pueden requerir la extensión o el proxy
Escritorio Peticiones directas sin restricciones de CORS
CLI (hopp) Ejecutar colecciones y pruebas en CI
Autoalojado Edición comunitaria con Docker; espacios de trabajo del equipo en infraestructura propia

Soporta REST, GraphQL (con exploración del esquema), WebSocket, Server-Sent Events, Socket.IO y MQTT. Importa colecciones de Postman, Insomnia y especificaciones OpenAPI.

Entornos y variables

Define variables por entorno (<<baseUrl>>, <<token>>) y márcalas como secretas para que no se sincronicen ni exporten con la colección. Cada persona introduce sus credenciales localmente.

Scripts y pruebas

// Pre-request: obtener un timestamp para firmar la petición
pw.env.set('ts', Date.now().toString());

// Tests: se ejecutan tras la respuesta
pw.test('responde 200', () => {
  pw.expect(pw.response.status).toBe(200);
});
pw.test('devuelve el crédito pedido', () => {
  pw.expect(pw.response.body.id).toBe(pw.env.get('creditoId'));
});

Ejecución en CI

npm install -g @hoppscotch/cli
hopp test colecciones/creditos.json -e entornos/staging.json

El comando devuelve un código distinto de cero si alguna prueba falla. Para colecciones como artefacto de producto, ver API request collection as API product artifact.

Hoppscotch frente a alternativas

Postman ofrece más funciones de plataforma (mocks, monitorización, gobernanza) con un modelo SaaS; Bruno guarda las colecciones como archivos en el repositorio; Hoppscotch destaca por ser ligero, open source y autoalojable.

Criterios de implementación

Evitar exportar secretos e incluir aserciones o ejecuciones automatizadas cuando corresponda. Evaluar proxy, CORS y capacidades del cliente elegido para el entorno del equipo.

Continúa en las fuentes

Documentación oficial para verificar detalles y explorar más.