Las pruebas de API se han convertido en un componente esencial del desarrollo de software moderno. Mientras herramientas como Postman han dominado el mercado durante años, Bruno emerge como una alternativa revolucionaria que está capturando la atención de desarrolladores y testers en 2025. Esta guía te llevará desde cero hasta realizar tus primeras pruebas de API con Bruno de manera profesional.
¿Qué Es Bruno y Por Qué Usarlo?
Bruno es un cliente de API open-source, rápido y centrado en Git que permite probar, desarrollar y documentar APIs de forma eficiente. A diferencia de Postman, Bruno almacena tus colecciones directamente en tu sistema de archivos usando un lenguaje de marcado simple llamado Bru, lo que facilita enormemente el control de versiones y la colaboración en equipo.
La principal ventaja de Bruno sobre otras herramientas es su enfoque offline-first. No necesitas crear cuentas, sincronizar con la nube ni depender de servicios externos. Todo vive en tu máquina, lo que significa mayor privacidad, velocidad y control total sobre tus datos de prueba.
Para equipos que trabajan con Git, Bruno representa un cambio de paradigma: tus colecciones de API son archivos de texto plano que pueden ser versionados, revisados en pull requests y compartidos sin fricciones con todo el equipo.
Instalación de Bruno Paso a Paso
Descargar e Instalar
La instalación de Bruno es sorprendentemente simple. Visita el sitio oficial usebruno.com y descarga la versión correspondiente a tu sistema operativo. Bruno está disponible para Windows, macOS y Linux, y el proceso de instalación es directo en todas las plataformas.
Para usuarios de macOS con Homebrew, la instalación es aún más sencilla:
bash
brew install bruno
```
En Windows, simplemente ejecuta el instalador descargado y sigue las instrucciones en pantalla. En minutos tendrás Bruno listo para comenzar a probar APIs.
### Primera Ejecución
Al abrir Bruno por primera vez, verás una interfaz limpia e intuitiva que recuerda a Postman pero con una filosofía diferente. No te pedirá crear cuenta ni iniciar sesión, simplemente estarás listo para trabajar.
La interfaz se divide en tres secciones principales: el explorador de colecciones a la izquierda, el editor de requests en el centro y el panel de respuestas en la parte inferior. Esta disposición maximiza la productividad y mantiene toda la información relevante visible.
## Creando Tu Primera Colección en Bruno
### Conceptos Básicos de Colecciones
En Bruno, una colección es simplemente una carpeta en tu sistema de archivos que contiene archivos .bru. Cada archivo representa una petición API individual. Esta estructura basada en archivos es lo que hace a Bruno tan poderoso para trabajo en equipo.
Para crear tu primera colección, haz clic en "Create Collection" en la pantalla inicial. Bruno te pedirá elegir una ubicación en tu disco duro. Elige una carpeta dentro de tu proyecto o repositorio Git para aprovechar al máximo las capacidades de versionado.
Nombra tu colección de manera descriptiva, por ejemplo "API-Testing-Proyecto" o "Backend-Endpoints". Una buena práctica es mantener una colección por proyecto o microservicio que estés probando.
### Estructura de Carpetas Recomendada
Organizar tus requests desde el principio te ahorrará dolores de cabeza futuros. Una estructura típica podría ser:
```
mi-api-collection/
├── Autenticación/
│ ├── Login.bru
│ └── Refresh-Token.bru
├── Usuarios/
│ ├── Crear-Usuario.bru
│ ├── Obtener-Usuario.bru
│ └── Actualizar-Usuario.bru
└── Productos/
├── Listar-Productos.bru
└── Crear-Producto.bru
```
Bruno respeta esta jerarquía de carpetas, mostrándola claramente en el explorador lateral. Puedes crear subcarpetas directamente desde la interfaz o mediante tu gestor de archivos.
## Tu Primera Petición API con Bruno
### Creando un GET Request Simple
Comencemos con algo básico: una petición GET a una API pública. Dentro de tu colección, haz clic derecho y selecciona "New Request". Bruno creará un nuevo archivo .bru y abrirá el editor.
En el campo URL, ingresa una API de prueba como:
```
https://jsonplaceholder.typicode.com/users
```
Selecciona el método GET del dropdown (viene por defecto) y haz clic en "Send". En segundos verás la respuesta JSON con una lista de usuarios de ejemplo. ¡Acabas de hacer tu primera llamada API con Bruno!
El panel de respuesta muestra el código de estado HTTP, el tiempo de respuesta, el tamaño del payload y, lo más importante, el cuerpo de la respuesta formateado y coloreado para fácil lectura.
### Entendiendo la Respuesta
Bruno presenta las respuestas de manera clara y organizada. Puedes cambiar entre vistas de Body, Headers, Cookies y Timeline. La vista Body muestra el JSON formateado automáticamente, permitiéndote expandir y colapsar objetos para navegar estructuras complejas.
Los códigos de estado HTTP aparecen coloreados: verde para 2xx (éxito), amarillo para 3xx (redirección), naranja para 4xx (error del cliente) y rojo para 5xx (error del servidor). Esta codificación visual permite identificar problemas rápidamente.
## Trabajando con Diferentes Métodos HTTP
### POST Requests con Body
Las peticiones POST son fundamentales para crear recursos. Crea un nuevo request en Bruno y selecciona POST como método. En la URL usa:
```
https://jsonplaceholder.typicode.com/postsNavega a la pestaña “Body” y selecciona “JSON” del dropdown. Ingresa un payload de ejemplo:
json
{
"title": "Mi primer POST con Bruno",
"body": "Este es el contenido del post",
"userId": 1
}
```
Al enviar este request, la API responderá con el objeto creado incluyendo un ID asignado. Bruno muestra claramente tanto tu request como la respuesta, facilitando debugging.
### PUT y DELETE para Actualización y Eliminación
Los métodos PUT y DELETE funcionan similarmente. Para actualizar un recurso, usa PUT con el ID específico en la URL:
```
https://jsonplaceholder.typicode.com/posts/1
```
Para eliminar, simplemente cambia el método a DELETE con la misma URL. Bruno maneja todos los métodos HTTP estándar: GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS.
## Headers y Autenticación en Bruno
### Agregando Headers Personalizados
Muchas APIs requieren headers específicos. En Bruno, ve a la pestaña "Headers" dentro de tu request. Aquí puedes agregar headers clave-valor fácilmente.
Headers comunes incluyen:
```
Content-Type: application/json
Accept: application/json
Authorization: Bearer tu-token-aqui
```
Bruno autocompleta nombres de headers comunes, acelerando tu flujo de trabajo. Puedes habilitar o deshabilitar headers individualmente usando checkboxes, útil para probar diferentes configuraciones.
### Configurando Autenticación
Para APIs que requieren autenticación, Bruno ofrece opciones integradas en la pestaña "Auth". Soporta varios tipos:
- Bearer Token: para autenticación basada en JWT
- Basic Auth: usuario y contraseña codificados en base64
- API Key: para servicios que usan keys en headers o query params
Selecciona el tipo apropiado e ingresa tus credenciales. Bruno aplicará automáticamente la autenticación correcta a tus requests.
## Variables de Entorno en Bruno
Una característica poderosa de Bruno es el manejo de variables de entorno. Esto te permite cambiar entre desarrollo, staging y producción sin editar cada request manualmente.
### Creando Environments
En la barra lateral, encontrarás la sección "Environments". Crea un nuevo ambiente llamado "Development" y define variables:
```
base_url: https://api-dev.miproyecto.com
api_key: dev_key_123456
```
Luego crea otro ambiente "Production" con valores diferentes. En tus requests, usa estas variables con la sintaxis:
```
{{base_url}}/usersBruno reemplazará automáticamente {{base_url}} con el valor del ambiente activo. Cambiar entre ambientes es tan simple como seleccionar otro del dropdown.
Guardando y Versionando con Git
Esta es donde Bruno realmente brilla. Navega a la carpeta de tu colección y verás archivos .bru en texto plano. Inicializa un repositorio Git:
bash
git init
git add .
git commit -m "Colección inicial de API tests"
```
Ahora tu equipo completo puede clonar el repositorio y tener acceso instantáneo a todas las pruebas de API. Los cambios en requests aparecen como diffs legibles en pull requests, algo imposible con herramientas basadas en la nube.
## Mejores Prácticas para Bruno
### Organización Clara
Mantén tus colecciones organizadas por módulos funcionales. Usa nombres descriptivos para requests: "POST Crear Usuario" es mejor que "Request 1".
### Documentación Inline
Bruno permite agregar descripciones a cada request. Úsalas para explicar qué prueba cada endpoint, qué respuesta se espera y cualquier configuración especial necesaria.
### Reutilización de Variables
Define variables para cualquier valor que se repita: URLs base, tokens, IDs de prueba. Esto facilita mantenimiento y reduce errores.
## Conclusión
Bruno representa el futuro de las pruebas de API: rápido, privado y perfectamente integrado con flujos de trabajo modernos basados en Git. En pocos minutos has aprendido a instalar Bruno, crear colecciones, realizar diferentes tipos de requests, manejar autenticación y aprovechar variables de entorno.
La curva de aprendizaje es mínima, pero el impacto en tu productividad es significativo. Al almacenar todo localmente y usar archivos de texto plano, Bruno elimina fricciones en la colaboración y te da control total sobre tus pruebas.
Empieza hoy con Bruno y experimenta una forma más eficiente y profesional de probar APIs. Tu equipo te lo agradecerá.
---
## **Metadatos para Yoast SEO:**
**Frase clave de enfoque:**
```
bruno primeros pasos probar api
```
**Título SEO:**
```
Bruno: Los Primeros Pasos para Probar API - Guía Completa 2025
```
**Slug:**
```
bruno-primeros-pasos-probar-api
```
**Meta descripción:**
```
Aprende a usar Bruno para probar APIs desde cero. Guía paso a paso con instalación, primera petición, autenticación y mejores prácticas en 2025.
