Resterm

Un banco de trabajo de API como código para la terminal.
resterm.app · docs

Resterm es un cliente de API que utiliza archivos .http/.rest como código fuente. Casi todas las funciones residen en archivos .http, por lo que son fáciles de revisar en Git o en cualquier otro sistema de control de versiones. Puedes enviar solicitudes, probar flujos de API, grabar tráfico HTTP y ejecutar servidores mock locales directamente desde la TUI, o ejecutar las mismas definiciones en scripts y CI con el comando resterm run.

Por qué Resterm

• Prueba flujos de API completos. Inicia sesión, captura un token, crea un recurso y verifica el resultado. Añade aserciones, bucles, condiciones, reintentos y scripts directamente en tus archivos de solicitud.
• Convierte tráfico real en mocks locales. Graba solicitudes y respuestas HTTP, y luego guárdalas como solicitudes ejecutables o definiciones de mock. Mantén los mocks junto a las solicitudes que los utilizan.
• Descubre qué cambió. Compara respuestas entre entornos, compara con resultados anteriores, inspecciona los tiempos de las solicitudes y perfila ejecuciones repetidas.
• Ejecuta las mismas comprobaciones localmente y en CI. Usa la interfaz de terminal durante el desarrollo y luego ejecuta esos archivos con resterm run. Exporta informes JSON o JUnit.
• Trabaja con varios protocolos. Envía solicitudes HTTP, GraphQL y gRPC, y trabaja con flujos WebSocket y SSE.

Los túneles SSH y los port-forwards de Kubernetes integrados te permiten acceder a APIs detrás de un bastión o dentro de un clúster.

Sin cuenta, sin telemetría, sin funciones de IA.

Capturas de pantalla

Traza y línea de tiempo

Haz clic para ver más de la interfaz

Flujos de trabajo

Perfilador

Explicación

RestermScript

Instalación

macOS y Linux:

brew install resterm
# or
curl -fsSL https://raw.githubusercontent.com/unkn0wn-root/resterm/main/install.sh | bash

Windows:

iwr -useb https://raw.githubusercontent.com/unkn0wn-root/resterm/main/install.ps1 | iex

Con Go 1.25 o superior:

go install github.com/unkn0wn-root/resterm/cmd/resterm@latest

Los binarios precompilados para macOS, Linux y Windows están en la página de releases. Los binarios de Linux necesitan glibc 2.32 o superior.

Para actualizar, ejecuta brew upgrade resterm si lo instalaste con Homebrew. De lo contrario, ejecuta resterm --update. Más información en la guía de instalación.

Inicio rápido

mkdir my-api && cd my-api
resterm init
resterm

resterm init crea un archivo requests.http con algunas solicitudes de ejemplo y mocks locales para responderlas, así que no necesitas una API real para probarlo. Pulsa g Shift+M para iniciar el servidor mock, mueve el cursor a una solicitud y pulsa Ctrl+Enter para enviarla. Pulsa ? para obtener ayuda en cualquier momento.

Tampoco necesitas init. Ejecuta resterm, escribe una URL o pega un comando curl y pulsa Ctrl+Enter.

El mismo archivo también se ejecuta sin la interfaz. Inicia los mocks en una terminal y ejecuta una solicitud en otra:

resterm mock requests.http                       # terminal 1
resterm run --request CreateUser requests.http   # terminal 2

Archivos de solicitud

Resterm lee el formato estándar .http y añade directivas # @ encima para la configuración y la automatización:

# @setting base-url https://api.example.com/v1/

### Create users
// Send this request once for each name in the list.
# @for-each ["david", "tom"] as name
# @when env.mode == "development"
# @assert response.statusCode == 201
POST users
Content-Type: application/json

{"name":"{{= name }}"}

Un @setting antes de la primera solicitud se aplica a todo el archivo. ### inicia una nueva solicitud. Las directivas encima de una solicitud pueden repetirla, omitirla o comprobar la respuesta.

Hay más ejemplos en _examples/, y todas las directivas están listadas en la referencia de archivos de solicitud.

Documentación

La documentación completa está en resterm.app/docs. Buenos puntos de partida son flujos de trabajo, servidores mock, grabación, la CLI y RestermScript.

Dentro de la TUI, :help <topic> abre el manual integrado y :docs <topic> abre la misma página en el sitio web.

Para ejecutar archivos de solicitud desde tu propio código Go, consulta el paquete headless.

Patrocinador

Resterm es y siempre será gratuito y de código abierto. Si te gusta mi trabajo, puedes patrocinarlo en GitHub.

Licencia

Apache License 2.0.