# OpenAPI para Postman Collection Converte uma spec OpenAPI 3.x ou Swagger 2.0 (JSON/YAML) em uma Postman Collection v2.1.0 importável com pastas, variáveis, auth e respostas de exemplo. > Página canônica: https://elysiatools.com/pt/tools/openapi-to-postman-collection - **Categoria:** Development - **Palavras-chave:** openapi para postman, swagger para postman, importar postman, conversor openapi, teste de api, newman ## Visão geral Cole a spec, baixe a coleção, importe no Postman (Import → File) ou rode com Newman — sem instalar pacotes Node. O conversor segue as convenções do openapi-to-postman oficial: servers[0] vira a variável {{baseUrl}} (barras finais removidas, servidores extras como baseUrl_2…, variáveis de servidor como {port} viram variáveis de coleção); pastas por caminho formam uma trie recolhida (ou use tags); parâmetros de caminho viram segmentos :param mais url.variable; parâmetros query/header ganham prefixo “(Required) ” e dicas de enum; corpos JSON são gerados com valores determinísticos (example → primeiro enum → default → por format → heurísticas como user@example.com); respostas de exemplo são salvas por código; esquemas bearer/basic/apiKey viram auth de coleção referenciando {{bearerToken}}/{{apiKey}}. Swagger 2.0 passa por uma camada de compatibilidade. Parâmetros cookie são descartados com aviso. ## Entradas - **Especificação OpenAPI / Swagger (JSON ou YAML)** (textarea): { "openapi": "3.0.3", "info": { "title": "My API" }, … - **Estratégia de pastas** (select) - **Incluir respostas de exemplo** (checkbox) - **Converter esquemas de segurança em auth** (checkbox) ## Quando usar - Quando você precisa testar ou debugar endpoints de uma API documentada em OpenAPI/Swagger dentro do Postman. - Ao configurar baterias de testes automatizados de API para execução via linha de comando com o Newman. - Para compartilhar rapidamente uma coleção organizada com autenticação e exemplos com outros desenvolvedores da equipe. ## Como funciona - Cole o conteúdo da sua especificação OpenAPI 3.x ou Swagger 2.0 em formato JSON ou YAML na área de texto. - Defina as opções de conversão, escolhendo a organização das pastas (por caminhos ou tags) e a inclusão de autenticação e respostas de exemplo. - Baixe o arquivo JSON gerado no padrão Postman Collection v2.1.0 e importe-o no Postman através do menu Import. ## Casos de uso - Transformar documentações Swagger 2.0 legadas em coleções modernas para validação de endpoints no Postman. - Gerar coleções estruturadas por tags com autenticação Bearer configurada para pipelines de CI/CD. - Criar payloads de teste com valores JSON determinísticos e exemplos de resposta para simulação de APIs. ## Perguntas frequentes ### Quais versões do OpenAPI e Swagger são suportadas? O conversor aceita especificações OpenAPI 3.0.x, 3.1.x e Swagger 2.0 nos formatos JSON e YAML. ### Como a URL base dos servidores é configurada na coleção? O primeiro servidor da lista é convertido na variável de coleção {{baseUrl}}, com barras finais removidas, e servidores adicionais recebem sufixos como baseUrl_2. ### O que acontece com parâmetros de cookies da especificação? Como o formato Postman Collection não suporta parâmetros de cookie nativamente nas requisições, eles são descartados durante a conversão. ### Como esquemas de segurança (Bearer, Basic, API Key) são tratados? Eles são convertidos em configurações de autenticação no nível da coleção apontando para variáveis como {{bearerToken}} ou {{apiKey}}. ### Posso executar o arquivo gerado diretamente no Newman? Sim, o arquivo gerado segue rigorosamente o esquema Postman Collection v2.1.0 e é totalmente compatível com o Newman. ## Ferramentas relacionadas - [Visualizador de diferencas de configuracao de ambiente](https://elysiatools.com/pt/tools/environment-config-diff-visualizer): Compara configuracoes JSON, YAML, TOML e ENV entre ambientes, destacando drift, chaves ausentes e sugestoes de limpeza. - [Gerador de OpenAPI para TypeScript](https://elysiatools.com/pt/tools/openapi-to-typescript-generator): Converte especificacoes OpenAPI ou Swagger em JSON/YAML em tipos TypeScript, parametros de requisicao e modelos de resposta com formato de saida e estilo de nomes configuraveis - [De paleta de imagem para design tokens](https://elysiatools.com/pt/tools/image-to-design-tokens): Extrai cores dominantes da imagem por k-means e exporta como variáveis CSS / SCSS / config Tailwind / tokens JSON, com nomes e escala de tons - [Gerador de Gráfico de Intervalo](https://elysiatools.com/pt/tools/range-chart-generator): Criar gráficos de intervalo para visualizar intervalos de valores mínimo-máximo com marcadores de mediana e detecção de outliers - [Conversor de JSON Schema para Zod](https://elysiatools.com/pt/tools/json-schema-to-zod-schema-converter): Converte definicoes JSON/YAML de JSON Schema em codigo Zod pronto para uso em projetos TypeScript, com objetos aninhados, arrays, enums e regras comuns de validacao - [Etiquetas PDF QR/Codigo de Barras](https://elysiatools.com/pt/tools/pdf-qr-barcode-labels): Gera etiquetas PDF em lote com QR e codigo de barras - [Removedor de Caracteres BOM](https://elysiatools.com/pt/tools/data-bom-remover): Remover caracteres BOM (Byte Order Mark) de conteúdo de texto e arquivos. Perfeito para limpar arquivos de texto com problemas de codificação. - [Limitador de Faixa de Dados](https://elysiatools.com/pt/tools/data-range-limiter): Limitar valores numéricos a faixas específicas através de recorte, filtragem ou marcação de valores fora da faixa. Perfeito para controle de qualidade de dados, limpeza de sensores, execução de regras de negócio e pré-processamento de dados. Recursos: - Recorte de faixa (recorta valores para limites mínimo/máximo) - Filtragem de faixa (remove linhas fora dos limites) - Marcação de faixa (marca valores modificados) - Configuração de faixa por coluna - Detecção automática de colunas numéricas - Múltiplas estratégias de processamento - Relatório detalhado de modificações - Análise estatística de alterações - Execução de regras de negócio Casos de Uso Comuns: - Validação e limpeza de dados de sensores - Preparação de entrada para machine learning - Controle e validação de qualidade de dados - Execução de restrições de negócio - Gerenciamento e controle de valores anômalos - Pipelines de pré-processamento de dados ## Exemplos - [Exemplos OpenAPI/Swagger](https://elysiatools.com/pt/samples/openapi-swagger): Exemplos abrangentes de documentação API usando OpenAPI 3.0 e especificações Swagger para serviços RESTful - [Exemplos de Rastreamento Distribuído](https://elysiatools.com/pt/samples/distributed-tracing-samples): Exemplos completos de rastreamento distribuído usando Jaeger, OpenTelemetry e ferramentas modernas de observabilidade - [Ferramenta de Empacotamento Parcel](https://elysiatools.com/pt/samples/parcel): Exemplos da ferramenta de empacotamento Parcel com configuração zero incluindo configuração de projeto, plugins e configuração avançada - [Exemplos de pnpm Package Manager](https://elysiatools.com/pt/samples/pnpm): Exemplos de gerenciador de pacotes rápido e eficiente em espaço de disco incluindo monorepo, configuração de workspace, e workflows avançados ## Conteúdo relacionado - [Ferramentas de intercambio JSON e traducao de formatos](https://elysiatools.com/pt/hubs/json-convert): Compare ferramentas de conversao JSON para CSV, YAML, TOML, GraphQL, XML, Markdown, Excel, BSON, EDN e outros formatos estruturados em um unico hub. - [Ferramentas de inspecao, diff e transformacao JSON](https://elysiatools.com/pt/hubs/json-utility): Reune em um so hub ferramentas para formatar JSON, comparar mudancas, inspecionar caminhos, validar schema, mesclar arquivos e transformar dados para fluxos de API e dados. - [Geradores de schema JSON, dados mock e fixtures de API](https://elysiatools.com/pt/hubs/json-generate): Ferramentas reunidas para geracao de schema JSON, construcao de payloads mock e preparacao de fixtures de API em um unico hub. - [Ferramentas de formatação, diff e normalização de JSON](https://elysiatools.com/pt/hubs/json-format): Compare ferramentas de formatação JSON, diff, revisão de logs, comparação de configuração e normalização de dados em um único hub para fluxos de revisão de JSON.