Repolode
OpenAPITools

OpenAPITools/openapi-generator

Gera SDKs de clientes de API, stubs de servidor e documentação em várias linguagens a partir de uma especificação OpenAPI (v2/v3).

Alternativa open source a:SwaggerHubStoplight Studio

Estrelas
26,806
Forks
7,720
Issues abertas
5,779
Último commit
há 7 horas

O que é?

O OpenAPI Generator recebe um arquivo de especificação OpenAPI e gera código automaticamente. Ele oferece bibliotecas cliente de API para uma ampla variedade de linguagens e frameworks, stubs de servidor para frameworks web comuns e documentação de API em formatos como HTML, Markdown e AsciiDoc. É compatível com OpenAPI 2.0 e 3.0, e o suporte à versão 3.1 está em beta.

O projeto é uma aplicação Java distribuída como JAR, fórmula do Homebrew, imagem Docker, wrapper npm e plugins para Maven/Gradle. Pode ser executado pela linha de comando, por ferramentas de build ou por um serviço web auto-hospedado que recebe uma especificação via HTTP e retorna um arquivo zip com o código gerado.

As equipes costumam usá-lo para evitar escrever e manter código cliente manualmente e manter os SDKs sincronizados com uma definição de API que muda ao longo dos builds de CI.

Recursos principais

  • 01Gera bibliotecas cliente de API para dezenas de linguagens e bibliotecas cliente HTTP.
  • 02Gera stubs de servidor para vários frameworks, incluindo Spring, FastAPI e Ktor.
  • 03Cria documentação de API em HTML, Markdown, AsciiDoc e outros formatos.
  • 04É compatível com especificações OpenAPI 2.0 e 3.0, e a versão 3.1 está em beta.
  • 05Disponível como CLI, imagem Docker, plugins para Maven e Gradle e serviço web auto-hospedado.

Casos de uso

  • Gerar um SDK tipado para uma API REST pública e compartilhá-lo com clientes.
  • Criar a estrutura inicial dos stubs de servidor a partir do design de uma API antes de começar a implementação.
  • Manter bibliotecas cliente sincronizadas com uma especificação de API por meio de pipelines de CI.
  • Gerar documentação de API atualizada em HTML ou Markdown a partir da especificação.

Tópicos

Perguntas frequentes

O que é openapi-generator?
Gera SDKs de clientes de API, stubs de servidor e documentação em várias linguagens a partir de uma especificação OpenAPI (v2/v3). O OpenAPI Generator recebe um arquivo de especificação OpenAPI e gera código automaticamente. Ele oferece bibliotecas cliente de API para uma ampla variedade de linguagens e frameworks, stubs de servidor para frameworks web comuns e documentação de API em formatos como HTML, Markdown e AsciiDoc. É compatível com OpenAPI 2.0 e 3.0, e o suporte à versão 3.1 está em beta.
openapi-generator é gratuito? Qual é a licença?
openapi-generator é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
openapi-generator ainda é mantido?
Manutenção ativa. O último commit de openapi-generator foi em 18 de out. de 2026.
Para que posso usar openapi-generator?
Gerar um SDK tipado para uma API REST pública e compartilhá-lo com clientes. Criar a estrutura inicial dos stubs de servidor a partir do design de uma API antes de começar a implementação. Manter bibliotecas cliente sincronizadas com uma especificação de API por meio de pipelines de CI. Gerar documentação de API atualizada em HTML ou Markdown a partir da especificação.
Onde consigo openapi-generator?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/OpenAPITools/openapi-generator

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados