Guia de Bruno

Paso a paso

1. 1

   Que hace diferente a Bruno

   A diferencia de Postman/Insomnia, Bruno no usa "workspaces en la nube". Todo vive en tu disco. Es perfecto para: developers que valoran privacidad, equipos que versionan collections en git, gente que no quiere crear cuenta.

2. 2

   Ve a usebruno.com/downloads

   https://www.usebruno.com/downloads. Veras: Windows (.exe), Mac (.dmg), Linux (.deb, .rpm, AppImage). Bruno es un proyecto open source con ~30k stars en GitHub.

3. 3

   Instala Bruno

   Windows: ejecuta el .exe, sigue el wizard (Next, Next, Install). Mac: arrastra al Applications. Linux: sudo dpkg -i Bruno_x.x.x.deb o equivalente.

4. 4

   Abre Bruno y familiarizate con la UI

   La primera vez veras una pantalla de bienvenida. Click en "Skip" o "Get Started". La UI tiene 3 areas: sidebar (collections), centro (editor de peticion), abajo (respuesta).

5. 5

   Click en el icono de folder "+" en el sidebar para crear una collection

   Te preguntara donde guardarla. Por defecto ~/Bruno. Crea una subcarpeta llamada "SAT API". Las collections en Bruno son carpetas reales en tu sistema de archivos.

6. 6

   Click derecho sobre la collection "SAT API" > "Import Collection"

   Veras opciones: "From File", "From URL", "From Postman", "From Insomnia". Elige "From URL" para importar directo desde la spec.

7. 7

   Pega https://api.cfdi4.com/docs/postman-spec y click "Import"

   Bruno descarga el JSON de la coleccion Postman, lo convierte a su formato nativo .bru, y crea los 33 archivos en tu carpeta. Toma unos segundos.

8. 8

   Crea un Environment (icono de llave inglesa > Environments)

   Un environment es donde guardas variables como api_key. En Bruno, los environments son archivos .env dentro de environments/ dentro de tu collection.

9. 9

   Crea un archivo "Produccion.env" con este contenido

   Abre un editor de texto (VSCode, Notepad, nano) y crea el archivo ~/Bruno/SAT API/environments/Produccion.env con: api_key=sat_xxxxxxxxxxxxxxxxxxxx (reemplaza con tu API key real). Guarda y cierra.

10. 10

    En Bruno, click en el dropdown de environment (esquina superior derecha) y selecciona "Produccion"

    A partir de ahora, todas las peticiones de esta collection usaran las variables del archivo Produccion.env.

11. 11

    Abre cualquier peticion de la collection

    Por ejemplo "Datos fiscales > POST datos-fiscales". Veras la peticion en lenguaje .bru: meta { name: "..." } + post { url: "..." } + headers { Authorization: "Bearer {{api_key}}" }.

12. 12

    Verifica que el header Authorization usa la variable {{api_key}}

    Si ves {{api_key}} (con dobles llaves), significa que se sustituye automaticamente por el valor del environment. Si ves un valor hardcodeado, editalo para que use la variable.

13. 13

    Click "Send"

    La respuesta aparece abajo. Veras: status (200/404/etc), tiempo, tamano, headers de respuesta, y body JSON con syntax highlighting.

14. 14

    Para ver el JSON formateado bonito, click en "Preview" abajo

    Bruno tiene 2 vistas: "Raw" (texto plano) y "Preview" (tree view colapsable). Preview es ideal para JSONs grandes.

15. 15

    Para commitear la collection a git, abre una terminal en la carpeta de la collection

    cd ~/Bruno/SAT\ API (o la ruta donde la guardaste). Inicializa git: git init. Crea .gitignore que ignore environments/*.env (porque tienen secrets). Despues: git add . && git commit -m "SAT API collection".

16. 16

    Para compartir con tu equipo, sube a un repo de GitHub/GitLab

    Cuando alguien clone el repo, abre Bruno, va a "Open Collection", elige la carpeta, y ya tiene todo listo. Crea su propio archivo .env con su API key. Cero friccion.

{
  "cfdi_codigo": 1,
  "cfdi_texto": "OK",
  "data": { ... }
}