Este es el título de una diapositiva que presenta el "Manual Práctico de Bruno". La subtítulo describe una guía paso a paso para pruebas y documentación de APIs.

Manual Práctico de Bruno

Guía paso a paso para pruebas y documentación de APIs

Source: Guía paso a paso para usar Bruno en documentación y ejecución de pruebas de API

La diapositiva presenta la agenda de una sesión sobre la herramienta Bruno para pruebas y documentación de APIs, cubriendo desde su introducción hasta funcionalidades avanzadas. Los temas incluyen instalación y configuración inicial, creación de colecciones y requests, ejecución y gestión de pruebas, y generación de documentación automática.

Agenda

1. 1. Introducción a Bruno

Presentación de la herramienta Bruno para pruebas y documentación de APIs.

2. 2. Instalación y Configuración Inicial

Guía paso a paso para instalar y configurar Bruno correctamente.

3. 3. Creación de Colecciones y Requests

Cómo organizar colecciones y configurar requests HTTP básicos.

4. 4. Ejecución y Gestión de Pruebas

Realizar pruebas, ver resultados y manejar variables en Bruno.

5. 5. Documentación y Funcionalidades Avanzadas

Generar documentación automática y explorar features avanzadas. Source: Bruno API Tool Manual Presentation

Bruno es una herramienta open-source para testing de APIs, similar a Postman, que se basa en archivos JSON sin necesidad de base de datos. Es ideal para colaboración en equipo vía Git y soporta nativamente HTTP/1.1, HTTP/2 y GraphQL.

¿Qué es Bruno?

• Herramienta open-source para testing de APIs, similar a Postman.
• Basada en archivos JSON, sin necesidad de base de datos.
• Ideal para colaboración en equipo mediante Git.
• Soporta HTTP/1.1, HTTP/2 y GraphQL nativamente.

Source: Bruno API Testing Tool

Para instalar Bruno, descarga la aplicación desde bruno.sh para Windows, macOS o Linux, e instálala ejecutando "bruno .". Crea un directorio 'bruno' para tus colecciones y disfruta de su interfaz intuitiva lista para usar.

Instalación de Bruno

• Descarga Bruno desde bruno.sh (Windows, macOS, Linux).
• Instala y ejecuta: bruno .
• Crea directorio 'bruno' para colecciones.
• Interfaz intuitiva lista para usar.

Source: Manual de Bruno para APIs

Este slide describe el workflow para crear y configurar requests en Bruno, comenzando por la creación de una nueva colección y request con nombre descriptivo. Luego detalla la definición del método y URL con variables de entorno, la configuración de headers y body (JSON o Form-Data), y la adición de autenticación y scripts pre/post-request en JavaScript.

Creación y Configuración de Requests en Bruno

Source: Manual Bruno - Pruebas de API

La diapositiva "Ejecución de Pruebas" presenta características clave de Bruno para ejecutar pruebas de API, como correr pruebas individuales desde la interfaz, escribir assertions con JavaScript y usar variables de entorno. Además, incluye generación de reportes en HTML/JSON y ejecución vía CLI para pipelines CI/CD.

Ejecución de Pruebas

Source: Bruno API Testing Manual

• Usar expect() para validar respuestas: expect(response.status).to.equal(200)
• Ejecutar scripts pre-request: preparar datos o autenticación antes
• Scripts post-request: verificar assertions y procesar resultados
• Acceder variables req: request.body, request.headers para personalizar
• Variables res: response.json(), response.body para tests dinámicos
• Ejemplos: assert JSON keys, validar tiempos de respuesta < 500ms

La diapositiva "Documentación Automática" presenta una tabla con características clave y su uso en una herramienta de API. Incluye UID único para identificar requests, exportación a Markdown con "bruno export .", historia de requests para revisar ejecuciones, y compartir vía Git para colaboración fácil.

Documentación Automática

Source: Bruno API Client