Importar Colecciones

GetMan soporta múltiples formatos de importación para que puedas migrar fácilmente desde otras herramientas.

Contenido

Formatos Soportados

P

Postman

Collection v2.1 (JSON)

B

Bruno

bruno.json + carpetas .bru

G

GetMan JSON

Formato nativo de GetMan

Cómo Importar

  1. 1

    Ve a tu workspace y haz clic en "Importar Colección" en el menú lateral o en el botón de añadir.

  2. 2

    Selecciona el formato de archivo que deseas importar.

  3. 3

    Arrastra y suelta el archivo o selecciónalo desde tu computadora.

  4. 4

    Revisa la previsualización y confirma la importación.

Estructura JSON de GetMan

El formato JSON nativo de GetMan permite definir colecciones completas con todas sus propiedades. A continuación se detalla la estructura completa:

Estructura de la Colección

{
  "name": "Mi API",
  "description": "Descripción de la colección",
  "auth_type": "bearer",
  "auth_data": {
    "token": "{{token}}"
  },
  "variables": [
    {
      "key": "base_url",
      "value": "https://api.ejemplo.com",
      "enabled": true
    },
    {
      "key": "token",
      "value": "mi-token-secreto",
      "enabled": true
    }
  ],
  "folders": [
    {
      "name": "Usuarios",
      "description": "Endpoints de usuarios",
      "order": 1,
      "requests": [...],
      "folders": [...]
    }
  ],
  "requests": [
    {
      "name": "Health Check",
      "method": "GET",
      "url": "{{base_url}}/health",
      ...
    }
  ]
}

Estructura de una Petición (Request)

{
  "name": "Obtener usuarios",
  "description": "Obtiene la lista de todos los usuarios",
  "method": "GET",
  "url": "{{base_url}}/api/users",
  "params": [
    {
      "key": "page",
      "value": "1",
      "description": "Número de página",
      "enabled": true
    },
    {
      "key": "limit",
      "value": "10",
      "description": "Cantidad por página",
      "enabled": true
    }
  ],
  "headers": [
    {
      "key": "Accept",
      "value": "application/json",
      "enabled": true
    },
    {
      "key": "Authorization",
      "value": "Bearer {{token}}",
      "enabled": true
    }
  ],
  "body_type": "none",
  "body": null,
  "auth_type": "inherit",
  "auth_data": null,
  "order": 1
}

Tipos de Body

none

Sin body (usado en GET, DELETE, etc.)

{
  "body_type": "none",
  "body": null
}

raw (JSON)

Body en formato JSON crudo

{
  "body_type": "raw",
  "body": {
    "raw": "{\n  \"name\": \"John Doe\",\n  \"email\": \"john@example.com\"\n}",
    "options": {
      "raw": {
        "language": "json"
      }
    }
  }
}

form-data

Datos de formulario multipart (para archivos)

{
  "body_type": "form-data",
  "body": {
    "formData": [
      {
        "key": "name",
        "value": "John Doe",
        "type": "text",
        "enabled": true
      },
      {
        "key": "avatar",
        "value": "",
        "type": "file",
        "enabled": true
      }
    ]
  }
}

x-www-form-urlencoded

Datos de formulario codificados en URL

{
  "body_type": "x-www-form-urlencoded",
  "body": {
    "urlencoded": [
      {
        "key": "username",
        "value": "john",
        "enabled": true
      },
      {
        "key": "password",
        "value": "secret123",
        "enabled": true
      }
    ]
  }
}

Tipos de Autenticación

Tipo auth_type auth_data
Sin autenticación none null
Heredar del padre inherit null
Basic Auth basic {"username": "user", "password": "pass"}
Bearer Token bearer {"token": "your-token"}
API Key api-key {"key": "X-API-Key", "value": "your-key", "in": "header"}

Métodos HTTP Soportados

GET POST PUT PATCH DELETE HEAD OPTIONS

Importar desde Postman

Pasos para exportar desde Postman:

  1. 1. Abre Postman y ve a la colección que deseas exportar
  2. 2. Haz clic en los tres puntos (...) de la colección
  3. 3. Selecciona "Export"
  4. 4. Elige el formato Collection v2.1
  5. 5. Guarda el archivo JSON
  6. 6. Importa el archivo en GetMan

GetMan convierte automáticamente las colecciones de Postman, incluyendo:

  • Variables de colección
  • Autenticación (Bearer, Basic, API Key)
  • Headers y parámetros
  • Body (JSON, form-data, urlencoded)
  • Estructura de carpetas
  • Descripciones y documentación

Importar desde Bruno

Pasos para importar desde Bruno:

  1. 1. Localiza la carpeta de tu colección de Bruno
  2. 2. Comprime toda la carpeta en un archivo ZIP
  3. 3. O copia el contenido del archivo bruno.json
  4. 4. Importa en GetMan seleccionando el formato Bruno

GetMan lee el archivo bruno.json y los archivos .bru para reconstruir la estructura de la colección.

Ejemplo Completo de Colección

A continuación un ejemplo completo de una colección JSON válida para importar en GetMan: 

{
  "name": "API de Usuarios",
  "description": "API REST para gestión de usuarios",
  "auth_type": "bearer",
  "auth_data": {
    "token": "{{access_token}}"
  },
  "variables": [
    {
      "key": "base_url",
      "value": "https://api.ejemplo.com/v1",
      "enabled": true
    },
    {
      "key": "access_token",
      "value": "",
      "enabled": true
    }
  ],
  "folders": [
    {
      "name": "Autenticación",
      "description": "Endpoints de autenticación",
      "order": 1,
      "requests": [
        {
          "name": "Login",
          "description": "Inicia sesión y obtiene un token de acceso",
          "method": "POST",
          "url": "{{base_url}}/auth/login",
          "headers": [
            {
              "key": "Content-Type",
              "value": "application/json",
              "enabled": true
            }
          ],
          "body_type": "raw",
          "body": {
            "raw": "{\n  \"email\": \"usuario@ejemplo.com\",\n  \"password\": \"contraseña123\"\n}"
          },
          "auth_type": "none",
          "order": 1
        },
        {
          "name": "Registro",
          "description": "Registra un nuevo usuario",
          "method": "POST",
          "url": "{{base_url}}/auth/register",
          "headers": [
            {
              "key": "Content-Type",
              "value": "application/json",
              "enabled": true
            }
          ],
          "body_type": "raw",
          "body": {
            "raw": "{\n  \"name\": \"Nuevo Usuario\",\n  \"email\": \"nuevo@ejemplo.com\",\n  \"password\": \"contraseña123\",\n  \"password_confirmation\": \"contraseña123\"\n}"
          },
          "auth_type": "none",
          "order": 2
        }
      ]
    },
    {
      "name": "Usuarios",
      "description": "CRUD de usuarios",
      "order": 2,
      "requests": [
        {
          "name": "Listar usuarios",
          "description": "Obtiene todos los usuarios con paginación",
          "method": "GET",
          "url": "{{base_url}}/users",
          "params": [
            {
              "key": "page",
              "value": "1",
              "enabled": true
            },
            {
              "key": "per_page",
              "value": "15",
              "enabled": true
            }
          ],
          "headers": [
            {
              "key": "Accept",
              "value": "application/json",
              "enabled": true
            }
          ],
          "auth_type": "inherit",
          "order": 1
        },
        {
          "name": "Obtener usuario",
          "description": "Obtiene un usuario por su ID",
          "method": "GET",
          "url": "{{base_url}}/users/1",
          "headers": [
            {
              "key": "Accept",
              "value": "application/json",
              "enabled": true
            }
          ],
          "auth_type": "inherit",
          "order": 2
        },
        {
          "name": "Crear usuario",
          "description": "Crea un nuevo usuario",
          "method": "POST",
          "url": "{{base_url}}/users",
          "headers": [
            {
              "key": "Content-Type",
              "value": "application/json",
              "enabled": true
            },
            {
              "key": "Accept",
              "value": "application/json",
              "enabled": true
            }
          ],
          "body_type": "raw",
          "body": {
            "raw": "{\n  \"name\": \"Juan Pérez\",\n  \"email\": \"juan@ejemplo.com\",\n  \"role\": \"user\"\n}"
          },
          "auth_type": "inherit",
          "order": 3
        },
        {
          "name": "Actualizar usuario",
          "description": "Actualiza los datos de un usuario",
          "method": "PUT",
          "url": "{{base_url}}/users/1",
          "headers": [
            {
              "key": "Content-Type",
              "value": "application/json",
              "enabled": true
            }
          ],
          "body_type": "raw",
          "body": {
            "raw": "{\n  \"name\": \"Juan Pérez Actualizado\",\n  \"email\": \"juan.nuevo@ejemplo.com\"\n}"
          },
          "auth_type": "inherit",
          "order": 4
        },
        {
          "name": "Eliminar usuario",
          "description": "Elimina un usuario del sistema",
          "method": "DELETE",
          "url": "{{base_url}}/users/1",
          "auth_type": "inherit",
          "order": 5
        }
      ]
    }
  ],
  "requests": [
    {
      "name": "Health Check",
      "description": "Verifica que la API está funcionando",
      "method": "GET",
      "url": "{{base_url}}/health",
      "auth_type": "none",
      "order": 0
    }
  ]
}

💡 Tip: Puedes usar variables con la sintaxis @{{variable}} que serán reemplazadas al ejecutar las peticiones.

¿Necesitas ayuda?

Si tienes problemas importando tu colección o el formato no es reconocido, contáctanos.

Contactar Soporte