Saltearse al contenido

Introducción a Rext HTTP

Rext HTTP es un cliente HTTP inteligente construido como extensión de VS Code. Introduce el formato de archivo .rext — una evolución del formato .http tradicional — diseñado para flujos de trabajo de API dinámicos y automatizados.

Las herramientas de API tradicionales tienen desventajas significativas:

  • Apps de escritorio de 500MB+ consumiendo tu RAM
  • Colecciones bloqueadas en formatos propietarios
  • Credenciales sincronizadas a nubes de terceros
  • Sin control de versiones, sin historial de Git
  • Cambio de contexto entre editor y herramientas

Rext resuelve todo esto manteniendo todo en texto plano, dentro de tu editor.

A diferencia de los archivos .http tradicionales, Rext introduce directivas inteligentes para manejar el ciclo de vida completo de una petición HTTP:

CaracterísticaDescripción
Captura de VariablesExtrae valores de las respuestas y reutilízalos
AsercionesValida códigos de estado, body, headers, duración
Cadenas de Pre-RequestEjecuta dependencias automáticamente antes de una petición
Configuración CompartidaDefine base URLs, headers, timeouts una vez
Archivos de EntornoCambia entre Dev, Staging, Producción con un click
Compatible con GitArchivos .rext en texto plano, amigables con diff

Aquí un ejemplo completo de cómo luce un archivo .rext:

@config
baseUrl: https://api.example.com
headers:
Content-Type: application/json
###
@id a1b2c3
@name Login
POST /auth/login
{
"email": "{{email}}",
"password": "{{password}}"
}
@capture env.token = body.access_token
@assert status == 200
###
@name Get Profile
@pre a1b2c3
GET /profile
Authorization: Bearer {{token}}
@assert status == 200
@assert body.email exists