# OpenAPI a Postman Collection Convierte una spec OpenAPI 3.x o Swagger 2.0 (JSON/YAML) en una Postman Collection v2.1.0 importable con carpetas, variables, auth y respuestas de ejemplo. > Página canónica: https://elysiatools.com/es/tools/openapi-to-postman-collection - **Categoría:** Development - **Palabras clave:** openapi a postman, swagger a postman, importar postman, convertidor openapi, pruebas api, newman ## Descripción general Pega la spec, descarga la colección, impórtala en Postman (Import → File) o ejecútala con Newman, sin instalar paquetes Node. El conversor sigue las convenciones del openapi-to-postman oficial: servers[0] se vuelve la variable {{baseUrl}} (sin barra final, servidores extra como baseUrl_2…, variables de servidor como {port} pasan a variables de colección); las carpetas por rutas forman un trie colapsado (o usa tags); los parámetros de ruta se vuelven segmentos :param más url.variable; los parámetros query/header llevan prefijo “(Required) ” y pistas de enum; los cuerpos JSON se generan con valores deterministas (example → primer enum → default → por format → heurísticas como user@example.com); se guardan respuestas de ejemplo por código; y los esquemas bearer/basic/apiKey se convierten en auth de colección con {{bearerToken}}/{{apiKey}}. Swagger 2.0 se acepta vía capa de compatibilidad. Los parámetros cookie se descartan con aviso. ## Entradas - **Especificación OpenAPI / Swagger (JSON o YAML)** (textarea): { "openapi": "3.0.3", "info": { "title": "My API" }, … - **Estrategia de carpetas** (select) - **Incluir respuestas de ejemplo** (checkbox) - **Convertir esquemas de seguridad en autenticación** (checkbox) ## Cuándo usarlo - Al migrar especificaciones OpenAPI o Swagger existentes a un entorno de pruebas interactivo en Postman. - Al preparar suites de pruebas automatizadas para pipelines de integración continua ejecutadas con el CLI de Newman. - Al distribuir contratos de API preconfigurados con ejemplos y esquemas de autenticación a equipos de desarrollo o QA. ## Cómo funciona - Pega la especificación OpenAPI 3.x o Swagger 2.0 en formato JSON o YAML en el área de texto. - Selecciona la estrategia de organización de carpetas (por rutas URL o por etiquetas) y configura la inclusión de ejemplos y autenticación. - Descarga el archivo JSON en formato Postman Collection v2.1.0 e impórtalo en Postman mediante Import → File o ejecútalo directamente con Newman. ## Casos de uso - Generación rápida de colecciones funcionales para pruebas manuales de nuevos servicios web. - Automatización de pruebas funcionales de endpoints en procesos CI/CD mediante Newman. - Estandarización de colecciones de API compartidas entre equipos de backend y frontend. ## Preguntas frecuentes ### ¿Qué versiones de OpenAPI y Swagger son compatibles? El conversor admite especificaciones OpenAPI 3.0, 3.1 y Swagger 2.0 tanto en sintaxis JSON como YAML. ### ¿Cómo se transforman las URLs de los servidores? El primer servidor se asigna a la variable {{baseUrl}} sin barra final, mientras que los servidores adicionales se guardan como {{baseUrl_2}} y variantes sucesivas. ### ¿Cómo se gestiona la autenticación definida en la spec? Los esquemas Bearer, Basic y API Key se convierten en la autenticación de la colección y quedan vinculados a variables como {{bearerToken}} o {{apiKey}}. ### ¿Qué sucede con los parámetros de tipo cookie? Los parámetros cookie se descartan durante la conversión porque el formato de colecciones de Postman no permite expresarlos directamente. ### ¿Cómo se generan los cuerpos de solicitud JSON? Se generan con valores deterministas evaluando campos de ejemplo, el primer valor de listas enum, valores predeterminados o formatos conocidos. ## Herramientas relacionadas - [Visualizador de diferencias de configuracion](https://elysiatools.com/es/tools/environment-config-diff-visualizer): Compara configuraciones JSON, YAML, TOML y ENV entre entornos, resaltando drift, claves faltantes y sugerencias de limpieza. - [Generador de OpenAPI a TypeScript](https://elysiatools.com/es/tools/openapi-to-typescript-generator): Convierte especificaciones OpenAPI o Swagger en JSON/YAML a tipos TypeScript, parametros de solicitud y modelos de respuesta con formato y nombres configurables - [De paleta de imagen a design tokens](https://elysiatools.com/es/tools/image-to-design-tokens): Extrae los colores dominantes de una imagen con k-means y expórtalos como variables CSS / SCSS / configuración Tailwind / tokens JSON, con nombres y escala de tonos - [Generador de Gráfico de Rango](https://elysiatools.com/es/tools/range-chart-generator): Crear gráficos de rango para visualizar rangos de valores mín-máx con marcadores de mediana y detección de valores atípicos - [Convertidor de JSON Schema a Zod](https://elysiatools.com/es/tools/json-schema-to-zod-schema-converter): Convierte definiciones JSON/YAML de JSON Schema en codigo Zod listo para usar en proyectos TypeScript, con objetos anidados, arreglos, enums y reglas comunes de validacion - [Etiquetas PDF QR/Codigo de Barras](https://elysiatools.com/es/tools/pdf-qr-barcode-labels): Genera etiquetas PDF por lotes con QR y codigo de barras - [Removedor de Caracteres BOM](https://elysiatools.com/es/tools/data-bom-remover): Eliminar caracteres BOM (Byte Order Mark) de contenido de texto y archivos. Perfecto para limpiar archivos de texto con problemas de codificación. - [Limitador de Rango de Datos](https://elysiatools.com/es/tools/data-range-limiter): Limitar valores numéricos a rangos específicos mediante recorte, filtrado o marcado de valores fuera de rango. Perfecto para control de calidad de datos, limpieza de sensores. ## Ejemplos - [Ejemplos OpenAPI/Swagger](https://elysiatools.com/es/samples/openapi-swagger): Ejemplos completos de documentación API usando OpenAPI 3.0 y especificaciones Swagger para servicios RESTful - [Muestras de Trazado Distribuido](https://elysiatools.com/es/samples/distributed-tracing-samples): Ejemplos completos de trazado distribuido usando Jaeger, OpenTelemetry y herramientas de observabilidad modernas - [Herramienta de Empaquetado Parcel](https://elysiatools.com/es/samples/parcel): Ejemplos de la herramienta de empaquetado Parcel de configuración cero incluyendo configuración de proyecto, plugins y configuración avanzada - [Ejemplos de pnpm Package Manager](https://elysiatools.com/es/samples/pnpm): Ejemplos de gestor de paquetes rápido y eficiente en espacio en disco incluyendo monorepo, configuración de workspace, y flujos de trabajo avanzados ## Contenido relacionado - [Herramientas de intercambio JSON y traduccion de formatos](https://elysiatools.com/es/hubs/json-convert): Compara herramientas de conversion JSON para CSV, YAML, TOML, GraphQL, XML, Markdown, Excel, BSON, EDN y otros formatos estructurados en un solo hub. - [Herramientas de inspeccion, diff y transformacion JSON](https://elysiatools.com/es/hubs/json-utility): Reune en un solo hub herramientas para formatear JSON, comparar cambios, inspeccionar rutas, validar esquemas, combinar archivos y transformar datos para flujos de API y datos. - [Generadores de esquemas JSON, datos mock y fixtures de API](https://elysiatools.com/es/hubs/json-generate): Herramientas reunidas para generacion de esquemas JSON, construccion de payloads mock y preparacion de fixtures de API en un solo hub. - [Herramientas de formato, diff y normalización de JSON](https://elysiatools.com/es/hubs/json-format): Compara herramientas de formato JSON, diff, revisión de logs, comparación de configuración y normalización de datos en un solo hub para flujos de revisión de JSON.