Peticiones y protocolos

Echo reúne cinco protocolos en un solo editor, para que dejes de cambiar de herramienta cuando una API no utiliza únicamente HTTP.

Los cinco protocolos

  • HTTP: el editor de peticiones del día a día, con método, cabeceras, cuerpo y autenticación por petición.
  • gRPC: transporte real basado en reflexión. Echo descubre servicios directamente desde el servidor y admite llamadas unarias y todos los modos de streaming.
  • GraphQL: introspección, variables y suscripciones.
  • WebSocket: establece la conexión y envía mensajes de forma interactiva, con una vista hexadecimal para los frames que no son de texto.
  • SSE: se suscribe a flujos de eventos enviados por el servidor y restablece la conexión automáticamente cuando se interrumpe el flujo.

Eliges el protocolo al crear una petición y el editor se adapta a él.

Autenticación

La autenticación se configura por petición y se hereda de las colecciones padre. Define Bearer, Basic, clave de API u OAuth2 client credentials una vez en una colección, y todas las peticiones que contiene usarán esa configuración salvo que una petición la sustituya por la suya.

Los tokens de OAuth2 client credentials se guardan en caché, por lo que los envíos repetidos no vuelven a negociar un token cada vez. Echo también admite OAuth2 authorization code con PKCE, AWS Signature V4, Digest, Hawk y NTLM. Elige el método que espera tu API y completa la configuración en la petición o en la colección padre.

Para APIs que usan un proxy o TLS mutuo, configura el proxy y los certificados de cliente en los ajustes avanzados del escritorio. Estos ajustes pertenecen al equipo donde ejecutas Echo.

Lee las respuestas

El visor de respuestas muestra el estado, las cabeceras y el cuerpo de cada llamada. Dos herramientas te ayudan a trabajar a lo largo del tiempo:

  • El historial de peticiones conserva tus llamadas anteriores y permite filtrarlas, para que sea fácil encontrar la petición que falló ayer.
  • El almacén de cookies registra las cookies e incluye un editor, útil cuando necesitas inspeccionar o ajustar una sesión manualmente.

Desglose de tiempos

Cada respuesta incluye un desglose de tiempos de red: DNS, TCP, TLS, tiempo hasta el primer byte y descarga. Así, "la API parece lenta" se convierte en una respuesta concreta sobre dónde se ha empleado realmente el tiempo.

Echo también mantiene una referencia para tus peticiones y muestra un aviso "más lenta de lo habitual" cuando una llamada queda por detrás, para que una regresión destaque antes de que alguien abra una incidencia.

Trabaja con eficiencia

Conviene adquirir pronto algunos hábitos:

  1. Abre la vista dividida para trabajar con hasta 4 paneles en paralelo, por ejemplo una petición, su equivalente gRPC y dos llamadas de referencia.
  2. Usa la paleta de comandos para saltar a cualquier lugar sin apartarte del teclado.
  3. Reasigna los atajos para adaptarlos a los hábitos que ya tienes de otras herramientas.

Próximos pasos

  • Deja de fijar nombres de host y tokens en la petición: /docs/echo/environments-and-variables
  • Ejecuta la misma petición en varios entornos a la vez: /docs/echo/environments-and-variables
  • Convierte peticiones en comprobaciones automatizadas: /docs/echo/automation