pt BR Como Importar uma Especificacao OpenAPI

Como Importar uma Especificação OpenAPI

Transforme uma definição OpenAPI/Swagger existente em um servidor com uma ferramenta por endpoint, sem definir nada manualmente.

Passos

1. Vá em Novo Servidor e escolha Importar especificação OpenAPI/Swagger.

   Abra o assistente Novo servidor na seleção de fonte de dados.

   

   Selecione REST API como fonte do servidor.

   

2. Envie seu arquivo de especificação (JSON ou YAML), ou cole sua URL.

   Continue para os detalhes do servidor.

   

   Nomeie o servidor que receberá a especificação importada.

   

3. Nomeie o servidor. Opcionalmente, ative melhorias assistidas por IA para obter nomes, descrições e schemas de ferramentas melhores — veja Provedores de IA.

   Abra a interface de importação OpenAPI e Postman.

   

   Enquadre a área de upload OpenAPI e os tipos de arquivo aceitos.

   

4. Revise as operações que o Arthur encontrou, depois crie o servidor.

   Mostre a URL base usada na importação ou descoberta da especificação.

   

Confirme que funcionou

O servidor abre na aba Ferramentas com uma ferramenta por endpoint importado, correspondendo à contagem de operações da sua especificação.

Bom saber

• Se a API precisar de uma credencial, armazene-a como um Segredo e a referencie na configuração de autenticação upstream do servidor, em vez de colá-la diretamente.
• Recebeu uma versão atualizada da mesma especificação depois? Use Como Reimportar uma Especificação de API Atualizada em vez de reconstruir o servidor.

Relacionado

• Ferramentas Dinâmicas
• Como Importar uma Coleção do Postman