Ir al contenido
↑↓ moverse↵ abriresc cerrar

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.

5 min de lectura

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.

Una colección pequeña exportada de Postman:

shop-api.postman_collection.json
{
"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.

El diálogo Importar de Postman o Bruno con una tarjeta para Postman y una para Bruno

Necesitas un workspace abierto. Si no hay ninguno, Luvin dice Abre o crea un workspace para importar. Mira Crear y abrir un workspace.

  1. 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.

  2. 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 Bruno

    También puedes soltar los archivos sobre el diálogo.

  3. 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.

  4. Cambia el nombre de la colección si quieres.

  5. Haz clic en Importar (N requests).

Para elegir otros archivos, haz clic en Elegir otros archivos.

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.

Primero necesitas una colección abierta. Luvin agrega los archivos a ella. Los archivos pueden ser .yaml, .yml o .json.

  1. Abre el inicio del workspace con el ícono de la casa de la barra superior.
  2. En Acciones rápidas, haz clic en Importar Arazzo o contratos.
  3. 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.

Un comando cURL es un request escrito como texto, como los que Chrome, Postman o la documentación de una API te dejan copiar.

Ventana de terminal
curl -X POST 'https://api.shop.test/customers' \
-H 'Content-Type: application/json' \
--data-raw '{"name":"Ana"}'

El diálogo Importar desde cURL con un comando pegado

  1. Haz clic en + de las pestañas (Crear o importar) y luego en Nuevo request.
  2. Haz clic en Importar desde cURL.
  3. Pega el comando. Se convierten el método, la URL, los headers, la autorización y el body.
  4. 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.

Para probar algo rápido, abre archivos sin workspace.

  1. 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.
  2. 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.