Empieza aquí
Trae tus propios archivos y requests
Importa archivos Arazzo y contratos, colecciones de Postman o Bruno y un comando cURL a Luvin, o abre archivos sin crear un workspace.
No tienes que empezar de cero. Puedes traer archivos Arazzo y contratos, colecciones de Postman o Bruno y un comando copiado como cURL.
Un archivo Arazzo describe un workflow. Un contrato es un archivo OpenAPI o AsyncAPI. Una colección es una carpeta de proyecto dentro de un workspace. Consulta el glosario.
Ejemplo: una colección de Postman
Sección titulada «Ejemplo: una colección de Postman»Una colección pequeña exportada de Postman:
{ "info": { "name": "Shop API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "item": [ { "name": "Customers", "item": [ { "name": "Get customer", "request": { "method": "GET", "url": "{{baseUrl}}/customers/42", "header": [{ "key": "Accept", "value": "application/json" }] } } ] } ]}Impórtala con un archivo de ambiente que defina baseUrl y Luvin crea una colección llamada Shop API:
Directorioshop-api/
- collection.yaml
Directoriorequests/
Directoriocustomers/
- _folder.request.yaml
- get-customer.request.yaml
Directorioenvironments/
- sandbox.yaml
En la barra lateral, Customers es una carpeta y Get customer un request que envía GET {{baseUrl}}/customers/42. Las variables del ambiente de Postman llegan a un ambiente de Luvin. Consulta Qué hay en disco.

Impórtala
Sección titulada «Impórtala»Necesitas un workspace abierto. Si no hay ninguno, Luvin dice Abre o crea un workspace para importar. Mira Crear y abrir un workspace.
-
Haz clic en + de las pestañas (Crear o importar) y luego en Importar de Postman o Bruno. La misma acción está en el menú ⋯ de Colecciones en la barra lateral y en el inicio del workspace, en Acciones rápidas.
-
Elige qué importar:
Herramienta Qué elegir Postman Elegir archivos .json: la colección exportada (v2.0 o v2.1). Elige también los archivos de ambiente para traer sus variables Bruno Elegir carpeta: la carpeta de la colección, como Bruno la guarda en git (con archivos .bru). O Elegir .json para el archivo que exporta BrunoTambién puedes soltar los archivos sobre el diálogo.
-
Lee el resumen. Para cada colección muestra la cantidad de requests, carpetas, ejemplos y ambientes, y la autorización de la colección si la hay.
-
Cambia el nombre de la colección si quieres.
-
Haz clic en Importar (N requests).
Para elegir otros archivos, haz clic en Elegir otros archivos.
Qué se importa y qué no
Sección titulada «Qué se importa y qué no»| Se importa | No se importa (el resumen lo lista antes de importar) |
|---|---|
| Carpetas y requests, con sus descripciones | Scripts (pre-request y tests). Luvin revisa las respuestas con criterios de éxito |
| Ejemplos guardados | Tipos de autorización sin equivalente: esos requests quedan sin autorización |
| Autorización de la colección, la carpeta y el request | Tipos de body sin equivalente: el body queda vacío |
| Ambientes y sus variables | Variables con un nombre no válido, y variables desactivadas |
| Variables de la colección |
- Una variable marcada como secreta sigue siendo secreta. Bruno no guarda el valor de sus secretos, así que llegan vacíos: escríbelos de nuevo en el ambiente.
- Las variables de la colección se agregan a cada ambiente que no las define. Si no llegó ningún ambiente, Luvin crea uno llamado
local.
Archivos Arazzo y contratos
Sección titulada «Archivos Arazzo y contratos»Primero necesitas una colección abierta. Luvin agrega los archivos a ella. Los archivos pueden ser .yaml, .yml o .json.
- Abre el inicio del workspace con el ícono de la casa de la barra superior.
- En Acciones rápidas, haz clic en Importar Arazzo o contratos.
- Elige uno o más archivos.
El botón solo aparece cuando hay una colección abierta. Una colección sin Arazzo muestra el mismo consejo.
- En Contratos, haz clic en + (Agregar contrato).
- Haz clic en Importar contrato….
- Elige el archivo.
- Arrastra los archivos desde tu explorador de archivos hasta la ventana de Luvin. Dice Suelta para agregar a «nombre de la colección».
- Suéltalos. Un mensaje dice cuántos se agregaron, por ejemplo Se agregaron 3 archivo(s) a la colección.
Si no hay una colección que los reciba, el mensaje es Abre o crea una colección para agregarle archivos. Los otros tipos de archivo se omiten y Luvin dice cuántos.
Un comando cURL
Sección titulada «Un comando cURL»Un comando cURL es un request escrito como texto, como los que Chrome, Postman o la documentación de una API te dejan copiar.
curl -X POST 'https://api.shop.test/customers' \ -H 'Content-Type: application/json' \ --data-raw '{"name":"Ana"}'
- Haz clic en + de las pestañas (Crear o importar) y luego en Nuevo request.
- Haz clic en Importar desde cURL.
- Pega el comando. Se convierten el método, la URL, los headers, la autorización y el body.
- Haz clic en Importar.
El comando debe empezar con curl e incluir una URL. Si no, Luvin dice que no parece un comando cURL válido. Los menús de requests de la barra lateral también ofrecen Importar desde cURL. Para copiar un paso como cURL, consulta cURL.
Abrir archivos sin workspace
Sección titulada «Abrir archivos sin workspace»Para probar algo rápido, abre archivos sin workspace.
- En la pantalla de bienvenida, haz clic en Abrir archivos sin workspace, abajo. El navegador abre un selector de archivos; la app de escritorio abre un selector de carpetas.
- Elige tus contratos, tus archivos Arazzo y los archivos a los que apuntan sus
$ref. También puedes soltarlos sobre la pantalla de bienvenida.
Si cierras la bienvenida con Prefiero explorar por mi cuenta, la pantalla vacía ofrece Abrir archivos y, en la app de escritorio, Abrir carpeta. De una carpeta se cargan todos los archivos YAML y JSON que tenga, con sus subcarpetas. Si tiene muchos archivos, solo se cargan los primeros 300, y Luvin lo avisa.