Gerador OpenApi
Se você deseja contribuir, consulte as diretrizes e uma lista de tarefas abertas.
‼ ️ Para migrar do Swagger CodeGen para o OpenAPI Generator, consulte o Guia de Migração ‼ ️
? Para mais informações, consulte a página do Wiki e as FAQ?
? O eBook A Beginner's Guide to Code Generation for Rest APIs é um bom ponto de partida para iniciantes?
️ Se a especificação do OpenAPI, modelos ou qualquer entrada (por exemplo, opções, variáveis de ambiente) for obtida de uma fonte ou ambiente não confiável, verifique se você revisou essas entradas antes de usar o gerador OpenAPI para gerar o cliente da API, servidor ou documentação para evitar Questões de segurança em potencial (por exemplo, injeção de código). Para vulnerabilidades de segurança, entre em contato com [email protected]. ️
‼ ️ Ambas "OpenAPI Tools" (https://openapitools.org - a organização -mãe do OpenAPI Generator) e "Openapi Generator" não são afiliados à OpenAPI Initiative (OAI) ‼ ️
Patrocinadores
Se você achar útil o OpenAPI Gerator para o trabalho, considere pedir à sua empresa que apoie este projeto de código aberto, tornando -se um patrocinador. Você também pode patrocinar individualmente o projeto, tornando -se um patrocinador.
Obrigado aos nossos patrocinadores de bronze!
Obrigado Godaddy por patrocinar os nomes de domínio, Linode para patrocinar o VPS, verifique se a API Monitoring e Gradle para patrocinar
Visão geral
O generador OpenAPI permite a geração de bibliotecas de clientes da API (geração SDK), stubs de servidor, documentação e configuração automaticamente, dadas uma especificação OpenAPI (os 2.0 e 3.0 são suportados). Atualmente, os seguintes idiomas/estruturas são suportados:
| Idiomas/estruturas |
---|
Clientes da API | ActionScript , Ada , Apex , Bash , C , C# (.net 2.0, 3.5 or later, .NET Standard 1.3 - 2.1, .NET Core 3.1, .NET 5.0. Libraries: RestSharp, GenericHost, HttpClient), C++ (Arduino, cpp -restsdk, Qt5, Tizen, Unreal Engine 4), Clojure , Crystal , Dart , Elixir , Elm , Eiffel , Erlang , Go , Groovy , Haskell (http-client, Servant), Java (Apache HttpClient 4.x, Apache HttpClient 5 .x, jersey2.x, okhttp, retrofit1.x, retrofit2.x, finge, resttemplate, descanso, vertx, biblioteca de clientes da API do Google para java, segura para descanso, primavera 5 cliente da web, primavera 6 Restclient, microprofile cliente, helidon ), Jetbrains HTTP Client , Julia , k6 , Kotlin , Lua , N4JS , Nim , Node.js/JavaScript (ES5, ES6, AngularJS with Google Closure Compiler annotations, Flow types, Apollo GraphQL DataStore), Objective-C , OCaml , Perl , PHP , PowerShell , Python , R , Ruby , Rust (hyper, reqwest, rust-server), Scala (akka, http4s, scalaz, sttp, swagger-async-httpclient, pekko), Swift (2.x, 3.x , 4.x, 5.x, 6.x), Typescript (AngularJS, Angular (9.x - 18.x), Aurelia, Axios, Fetch, Inversify, jQuery, Nestjs, Node, redux-query, Rxjs), XoJo , Zapier |
Stubs de servidor | Ada , C# (ASP.NET Core, Azure Functions), C++ (Pistache, Restbed, Qt5 QHTTPEngine), Erlang , F# (Giraffe), Go (net/http, Gin, Echo), Haskell (Servant, Yesod), Java ( MSF4J, Spring, Undertow, JAX-RS: CDI, CXF, Inflector, Jersey, RestEasy, Play Framework, PKMST, Vert.x, Apache Camel, Helidon), Julia , Kotlin (Spring Boot, Ktor, Vert.x), PHP (Flight, Laravel, Lumen, Mezzio (fka Zend Expressive), Slim, Silex, Symfony), Python (FastAPI, Flask), NodeJS , Ruby (Sinatra, Rails5), Rust (rust-server), Scala (Akka, Finch, LAGOM, Play, Cask, Scalatra) |
Geradores de documentação da API | HTML , Confluence Wiki , Asciidoc , Markdown , PlantUML |
Arquivos de configuração | Apache2 |
Outros | GraphQL , JMeter , Ktorm , MySQL Schema , Postman Collection , Protocol Buffer , WSDL |
Índice
- Gerador OpenApi
- Visão geral
- Índice
- 1 - Instalação
- 1.1 - Compatibilidade
- 1.2 - Artefatos no Maven Central
- 1.3 - Download Jar
- 1.4 - Construir projetos
- 1.5 - Homebrew
- 1.6 - Docker
- 1.7 - NPM
- 2 - Introdução
- 3 - Uso
- 3.1 - Personalização
- 3.2 - Integração do fluxo de trabalho
- 3.3 - geradores online
- 3.4 - Informações de licença no código gerado
- 3.5 - Integração IDE
- 4 - Empresas/projetos usando gerador OpenAPI
- 5 - Apresentações/Vídeos/Tutoriais/Livros
- 6 - Sobre nós
- 6.1 - Equipe Core do Gerador Openapi
- 6.2 - Comitê Técnico do Gerador Openapi
- 6.3 - História do gerador Openapi
- 7 - Licença
1 - Instalação
1.1 - Compatibilidade
A especificação do OpenAPI passou por 3 revisões desde a criação inicial em 2010. O projeto OpenApi-Generator possui as seguintes compatibilidades com a especificação OpenAPI:
Versão do gerador OpenAPI | Data de lançamento | Notas |
---|
7.11.0 (próximo lançamento menor) instantâneo | 20.12.2024 | Liberação menor com mudanças de ruptura (com fallback) |
7.10.0 (mais recente lançamento estável) | 18.11.2024 | Liberação menor com mudanças de ruptura (com fallback) |
6.6.0 | 11.05.2023 | Liberação menor com mudanças de ruptura (com fallback) |
5.4.0 | 31.01.2022 | Liberação menor com mudanças de ruptura (com fallback) |
4.3.1 | 06.05.2020 | Liberação de patches (aprimoramentos, correções de bugs, etc) |
Compatibilidade do OpenApi Spec: 1.0, 1.1, 1.2, 2.0, 3.0, 3.1 (suporte beta)
(Não publicamos a construção diária/noturna. Por favor, use o instantâneo)
For old releases, please refer to the Release page.
Para geradores/bibliotecas/estruturas descomissionados, consulte o rótulo "Decomissão" na página Solicitação de tração.
1.2 - Artefatos no Maven Central
Você pode encontrar nossos artefatos lançados no Maven Central:
Essencial:
< dependency >
< groupId >org.openapitools</ groupId >
< artifactId >openapi-generator</ artifactId >
< version >${openapi-generator-version}</ version >
</ dependency >
Veja as diferentes versões do artefato-gerador OpenApi disponíveis no Maven Central.
CLI:
< dependency >
< groupId >org.openapitools</ groupId >
< artifactId >openapi-generator-cli</ artifactId >
< version >${openapi-generator-version}</ version >
</ dependency >
Veja as diferentes versões do artefato OpenApi-Generator-Cli disponíveis no Maven Central.
Plugin maven:
< dependency >
< groupId >org.openapitools</ groupId >
< artifactId >openapi-generator-maven-plugin</ artifactId >
< version >${openapi-generator-version}</ version >
</ dependency >
- Veja as diferentes versões do artefato OpenApi-Generator-Maven-Plugin Disponed in Maven Central.
- Readme
Plugin gradle:
< dependency >
< groupId >org.openapitools</ groupId >
< artifactId >openapi-generator-gradle-plugin</ artifactId >
< version >${openapi-generator-version}</ version >
</ dependency >
- Veja as diferentes versões do artefato OpenApi-Generator-Gradle-Plugin Disponing in Maven Central.
- Readme
1.3 - Download Jar
Se você está procurando a versão estável mais recente, pode pegá -la diretamente do Maven.org (Java 11 Runtime no mínimo):
JAR location: https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/7.10.0/openapi-generator-cli-7.10.0.jar
For Mac/Linux users:
wget https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/7.10.0/openapi-generator-cli-7.10.0.jar -O openapi-generator-cli.jar
For Windows users, you will need to install wget or you can use Invoke-WebRequest in PowerShell (3.0+), eg
Invoke-WebRequest -OutFile openapi-generator-cli.jar https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/7.10.0/openapi-generator-cli-7.10.0.jar
After downloading the JAR, run java -jar openapi-generator-cli.jar help
to show the usage.
For Mac users, please make sure Java 11 is installed (Tips: run java -version
to check the version), and export JAVA_HOME
in order to use the supported Java version:
export JAVA_HOME= ` /usr/libexec/java_home -v 1.11 `
export PATH= ${JAVA_HOME} /bin: $PATH
Script de lançador
Uma desvantagem para downloads manuais de jar é que você não se mantém atualizado com a versão mais recente lançada. Temos um script Bash Launcher no BIN/UTILS/OpenApi-generator.cli.sh, que resolve esse problema.
Para instalar o script do iniciador, copie o conteúdo do script para um local no seu caminho e faça o script executável.
Um exemplo de configuração disso (Nota: sempre avalie os scripts enrolados de sistemas externos antes de executá -los).
mkdir -p ~/bin/openapitools
curl https://raw.githubusercontent.com/OpenAPITools/openapi-generator/master/bin/utils/openapi-generator-cli.sh > ~/bin/openapitools/openapi-generator-cli
chmod u+x ~/bin/openapitools/openapi-generator-cli
export PATH=$PATH:~/bin/openapitools/
Now, openapi-generator-cli
is "installed". Na Invocation, ele consultará o repositório do GitHub para a versão lançada recentemente. Se isso corresponder ao último frasco baixado, ele será executado normalmente. Se uma versão mais recente for encontrada, o script baixará a versão mais recente e a executará.
If you need to invoke an older version of the generator, you can define the variable OPENAPI_GENERATOR_VERSION
either ad hoc or globally. Você pode exportar essa variável se quiser persistir uma versão de versão específica.
Exemplos:
# Execute latest released openapi-generator-cli
openapi-generator-cli version
# Execute version 4.1.0 for the current invocation, regardless of the latest released version
OPENAPI_GENERATOR_VERSION=4.1.0 openapi-generator-cli version
# Execute version 4.1.0-SNAPSHOT for the current invocation
OPENAPI_GENERATOR_VERSION=4.1.0-SNAPSHOT openapi-generator-cli version
# Execute version 4.0.2 for every invocation in the current shell session
export OPENAPI_GENERATOR_VERSION=4.0.2
openapi-generator-cli version # is 4.0.2
openapi-generator-cli version # is also 4.0.2
# To "install" a specific version, set the variable in .bashrc/.bash_profile
echo "export OPENAPI_GENERATOR_VERSION=4.0.2" >> ~/.bashrc
source ~/.bashrc
openapi-generator-cli version # is always 4.0.2, unless any of the above overrides are done ad hoc
1.4 - Construir projetos
To build from source, you need the following installed and available in your $PATH:
Depois de clonar o projeto, você pode construí -lo a partir da fonte usando o Maven Wrapper:
- Linux:
./mvnw clean install
- Windows:
mvnw.cmd clean install
Usuários de nix
Se você é um usuário do NIX, pode entrar no shell do generador OpenAPI, digitando:
Ele entrará em um shell com o Java 11 instalado.
Direnv suporta o carregamento automaticamente do shell do desenvolvedor NIX; portanto, se você estiver usando o direnv também, digite:
and have java
and mvn
set up with correct versions each time you enter project directory.
A compilação padrão contém análise estática mínima (via estilo de seleção). To run your build with PMD and Spotbugs, use the static-analysis
profile:
- Linux:
./mvnw -Pstatic-analysis clean install
- Windows:
mvnw.cmd -Pstatic-analysis clean install
1.5 - Homebrew
To install, run brew install openapi-generator
Aqui está um exemplo de uso para gerar um cliente Ruby:
openapi-generator generate -i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml -g ruby -o /tmp/test/
To reinstall with the latest master, run brew uninstall openapi-generator && brew install --HEAD openapi-generator
Para instalar o OpenJDK (pré-requisitos), execute
brew tap AdoptOpenJDK/openjdk
brew install --cask adoptopenjdk11
export JAVA_HOME= ` /usr/libexec/java_home -v 1.11 `
ou baixe o instalador via https://adoptium.net/
Para instalar o Maven (opcional), execute
1.6 - Docker
Imagens públicas de docker pré-construído
- https://hub.docker.com/r/openapitools/openapi-generator-cli/ (cli oficial)
- https://hub.docker.com/r/openapitools/openapi-generator-online/ (serviço oficial da web)
Imagem do Docker do Gerador Openapi
A imagem do gerador OpenAPI atua como um executável independente. Ele pode ser usado como uma alternativa à instalação via Homebrew ou para desenvolvedores que não conseguem instalar o Java ou atualizar a versão instalada.
Para gerar código com esta imagem, você precisará montar um local local como volume.
Exemplo:
docker run --rm -v " ${PWD} :/local " openapitools/openapi-generator-cli generate
-i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml
-g go
-o /local/out/go
The generated code will be located under ./out/go
in the current directory.
Imagem do docker online do gerador OpenApi
A imagem do OpenApi-Generator-onLine pode atuar como um aplicativo da Web auto-hospedado e API para gerar código. Este contêiner pode ser incorporado a um pipeline de CI e requer pelo menos duas solicitações HTTP e alguma orquestração do Docker para acessar o código gerado.
Exemplo de uso:
# Start container at port 8888 and save the container id
> CID= $( docker run -d -p 8888:8080 openapitools/openapi-generator-online )
# allow for startup
> sleep 10
# Get the IP of the running container (optional)
GEN_IP= $( docker inspect --format ' {{.NetworkSettings.IPAddress}} ' $CID )
# Execute an HTTP request to generate a Ruby client
> curl -X POST --header ' Content-Type: application/json ' --header ' Accept: application/json '
-d ' {"openAPIUrl": "https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml"} '
' http://localhost:8888/api/gen/clients/ruby '
{ " code " : " c2d483.3.4672-40e9-91df-b9ffd18d22b8 " , " link " : " http://localhost:8888/api/gen/download/c2d483.3.4672-40e9-91df-b9ffd18d22b8 " }
# Download the generated zip file
> wget http://localhost:8888/api/gen/download/c2d483.3.4672-40e9-91df-b9ffd18d22b8
# Unzip the file
> unzip c2d483.3.4672-40e9-91df-b9ffd18d22b8
# Shutdown the openapi generator image
> docker stop $CID && docker rm $CID
Desenvolvimento em Docker
You can use run-in-docker.sh
to do all development. This script maps your local repository to /gen
in the docker container. It also maps ~/.m2/repository
to the appropriate container location.
To execute mvn package
:
git clone https://github.com/openapitools/openapi-generator
cd openapi-generator
./run-in-docker.sh mvn package
Os artefatos de construção agora estão acessíveis em seu diretório de trabalho.
Once built, run-in-docker.sh
will act as an executable for openapi-generator-cli. To generate code, you'll need to output to a directory under /gen
(eg /gen/out
). Por exemplo:
./run-in-docker.sh help # Executes 'help' command for openapi-generator-cli
./run-in-docker.sh list # Executes 'list' command for openapi-generator-cli
./run-in-docker.sh generate -i modules/openapi-generator/src/test/resources/3_0/petstore.yaml
-g go -o /gen/out/go-petstore -p packageName=petstore # generates go client, outputs locally to ./out/go-petstore
Solução de problemas
If an error like this occurs, just execute the ./mvnw clean install -U command:
org.apache.maven.lifecycle.lifecyclexecutionException: Falha ao executar o objetivo org.apache.maven.plugins: maven-surefire-plugin: 2.19.1: teste (teste padrão) no projeto OpenApi-gerador: um tipo de incompatibilidade ocorreu durante a execução da execução durante org.apache.maven.plugins: maven-surefire-plugin: 2.19.1: teste: java.lang.ExceptioninInitializerError não pode ser lançado para java.io.ioException
./run-in-docker.sh ./mvnw clean install -U
Falha ao executar o objetivo Org.formasoft: gradle-maven-plugin: 1.0.8: Invoke (padrão) no projeto OpenApi-Generator-Gradle-Plugin-Mvn-Wrapper: org.gradle.tooling.buildException: não conseguiu executar a construção usando graduação Distribuição 'https://services.gradle.org/distributions/gradle-4.7-bin.zip'
Agora: nenhuma solução para este: |
Corra Docker em Vagrant
Pré -requisito: Instale o Vagrant e o VirtualBox.
git clone https://github.com/openapitools/openapi-generator.git
cd openapi-generator
vagrant up
vagrant ssh
cd /vagrant
./run-in-docker.sh ./mvnw package
1.7 - NPM
Há também um invólucro de pacote NPM disponível para diferentes plataformas (por exemplo, Linux, Mac, Windows). (A JVM ainda é necessária) Consulte o ReadMe do projeto para obter mais informações.
Instale -o globalmente para obter a CLI disponível na linha de comando:
npm install @openapitools/openapi-generator-cli -g
openapi-generator-cli version
Para usar uma versão específica de "OpenApi-gerador-cli"
openapi-generator-cli version-manager set 7.10.0
Ou instale-o como dependência de dev:
npm install @openapitools/openapi-generator-cli -D
You can use locally built JARs or SNAPSHOT
versions as well.
2 - Introdução
Para gerar um cliente PHP para petstore.yaml, execute o seguinte
git clone https://github.com/openapitools/openapi-generator
cd openapi-generator
./mvnw clean package
java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar generate
-i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml
-g php
-o /var/tmp/php_api_client
(if you're on Windows, replace the last command with java -jar modulesopenapi-generator-clitargetopenapi-generator-cli.jar generate -i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml -g php -oc:tempphp_api_client
)
Você também pode baixar o jar (mais recente lançamento) diretamente do Maven.org
To get a list of general options available, please run java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar help generate
To get a list of PHP specified options (which can be passed to the generator with a config file via the -c
option), please run java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar config-help -g php
3 - Uso
Para gerar uma biblioteca de clientes de amostra
Você pode construir um cliente contra a API da PetStore da seguinte maneira:
./bin/generate-samples.sh ./bin/configs/java-okhttp-gson.yaml
(No Windows, instale o Git Bash para o Windows para executar o comando acima)
This script uses the default library, which is okhttp-gson
. Ele executará o gerador com este comando:
java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar generate
-i https://raw.githubusercontent.com/openapitools/openapi-generator/master/modules/openapi-generator/src/test/resources/3_0/petstore.yaml
-g java
-t modules/openapi-generator/src/main/resources/Java
--additional-properties artifactId=petstore-okhttp-gson,hideGenerationTimestamp=true
-o samples/client/petstore/java/okhttp-gson
com várias opções. As opções Java estão documentadas aqui.
You can also get the options with the help generate
command (below only shows partial results):
NAME
openapi-generator-cli generate - Generate code with the specified
generator.
SYNOPSIS
openapi-generator-cli generate
[(-a <authorization> | --auth <authorization>)]
[--api-name-suffix <api name suffix>] [--api-package <api package>]
[--artifact-id <artifact id>] [--artifact-version <artifact version>]
[(-c <configuration file> | --config <configuration file>)] [--dry-run]
[(-e <templating engine> | --engine <templating engine>)]
[--enable-post-process-file]
[(-g <generator name> | --generator-name <generator name>)]
[--generate-alias-as-model] [--git-host <git host>]
[--git-repo-id <git repo id>] [--git-user-id <git user id>]
[--global-property <global properties>...] [--group-id <group id>]
[--http-user-agent <http user agent>]
[(-i <spec file> | --input-spec <spec file>)]
[--ignore-file-override <ignore file override location>]
[--import-mappings <import mappings>...]
[--instantiation-types <instantiation types>...]
[--invoker-package <invoker package>]
[--language-specific-primitives <language specific primitives>...]
[--legacy-discriminator-behavior] [--library <library>]
[--log-to-stderr] [--minimal-update]
[--model-name-prefix <model name prefix>]
[--model-name-suffix <model name suffix>]
[--model-package <model package>]
[(-o <output directory> | --output <output directory>)] [(-p <additional properties> | --additional-properties <additional properties>)...]
[--package-name <package name>] [--release-note <release note>]
[--remove-operation-id-prefix]
[--reserved-words-mappings <reserved word mappings>...]
[(-s | --skip-overwrite)] [--server-variables <server variables>...]
[--skip-validate-spec] [--strict-spec <true/false strict behavior>]
[(-t <template directory> | --template-dir <template directory>)]
[--type-mappings <type mappings>...] [(-v | --verbose)]
OPTIONS
-a <authorization>, --auth <authorization>
adds authorization headers when fetching the OpenAPI definitions
remotely. Pass in a URL-encoded string of name:header with a comma
separating multiple values
...... (results omitted)
-v, --verbose
verbose mode
Você pode compilar e executar o cliente, bem como testes de unidade contra ele:
cd samples/client/petstore/java/okhttp-gson
mvn package
Outros geradores também têm amostras.
3.1 - Personalização
Consulte a personalização.md sobre como personalizar a saída (por exemplo, nome do pacote, versão)
3.2 - Integração do fluxo de trabalho (maven, gradle, github, ci/cd)
Consulte a integração.md sobre como integrar o generador OpenAPI com maven, gradle, sbt, bazel, github e ci/cd.
3.3 - Gerador OpenAPI online
Aqui estão os serviços públicos on -line:
- Última versão estável: https://api.openapi-generator.tech
- Mestre mais recente: https://api-latest-master.openapi-generator.tech (atualizado com o último mestre a cada hora)
O servidor é patrocinado pela Linode
(Esses serviços são beta e não têm garantia no nível de serviço)
Please refer to online.md on how to run and use the openapi-generator-online
- a web service for openapi-generator
.
3.4 - Informações de licença no código gerado
O projeto do generador OpenAPI pretende ser um benefício para os usuários da especificação da API aberta. O projeto em si tem a licença conforme especificado. Além disso, entenda os seguintes pontos:
- Os modelos incluídos neste projeto estão sujeitos à licença.
- Generated code is intentionally not subject to the parent project license
When code is generated from this project, it shall be considered AS IS and owned by the user of the software. Não há garantias-expressas ou implícitas-para o código gerado. Você pode fazer o que deseja e, uma vez gerado, o código é de sua responsabilidade e sujeito aos termos de licenciamento que você considera apropriado.
3.5 - Integração IDE
Aqui está uma lista de plug-ins de IDE com comunidade que se integram ao gerador OpenAPI:
- Eclipse: CodeWind OpenApi Tools for Eclipse by IBM
- Intellij Idea: Openapi Generator por Jim Schubert
- Ideia Intellij: editor senya por senya.io
- REPREZEN API Studio
- Visual Studio: Gerador de código de cliente da API REST por Christian Resma Helle
- Código do Visual Studio: CodeWind OpenApi Tools by IBM
4 - Empresas/projetos usando gerador OpenAPI
Aqui estão algumas empresas/projetos (ordem alfabética) usando gerador OpenAPI em produção. Para adicionar sua empresa/projeto à lista, visite readme.md e clique no ícone para editar a página.
- Universidade de Aalborg
- codificação do ato
- Soluções Adaptant AG
- ADESSO SE
- Adyen
- Agoda
- Airthings
- Aleri Solutions GmbH
- Allianz
- Angular.Schule
- Aqovia
- Grupo Bancário da Austrália e Nova Zelândia (ANZ)
- Arduino
- Askul
- Amazon Web Services (AWS)
- B <> com
- 百度营销
- Largura de banda
- Cloud Banzai
- Bimdata.io
- Bithost GmbH
- Indústria conectada de Bosch
- Boxever
- Brevy
- Bunker Holding Group
- Universidade Estadual da Califórnia, Northridge
- Cam
- Camptocamp
- Grupo Carlsberg
- CERN
- Christopher Queen Consulting
- Cisco
- codecentric ag
- Coinapi
- Invencis
- ConfigCat
- Cronn GmbH
- Crossover Health
- Cupix
- Datadog
- Systel dB
- Deeporute.ai
- DevSupply
- DMTech GmbH
- Docspring
- Dwango
- Impulso de borda
- Elemento ai
- Embalóticos
- Emineo
- rapidamente
- Fenergo
- Freee
- FreshCells
- Fusível
- Gantner
- GenFlow
- Getyourguide
- Glovo
- OGM Pepabo
- Godaddy
- Gumtree
- Aqui
- IBM
- Instana
- Interxion
- Inquisico
- JustStar
- K6.io
- Klarna
- Desenvolvimento de Kronsoft
- Kubernetes
- Landeshauptstadt München - It@M
- Linode
- LogicDrop
- Lumeris
- LVM Versicherungen
- Mailslurp
- Pesquisa de Manticore
- MasterCard
- MédiaVision
- Metaswitch
- LONVISION
- Myworkout
- Namsor
- NeverFail
- Neuerenergy
- Nokia
- OneSignal
- Corporação de compensação de opções (OCC)
- Open
- OpenValidation
- Oráculo
- Paxos
- Xadrez
- Plaid, Inc.
- Pinterest
- Ponicode
- Pricefx
- Printnanny
- Prometheus/AlertManager
- Qavar
- Qedit
- Qovery
- Sistemas Qulix
- Raksul
- Raiffeisen Schweiz Genossenschaft
- Redhat
- REPREZEN API Studio
- Rest United
- Robocorp
- Robotinfra
- Searchapi
- Smarthr
- Sony Interactive Entertainment
- Dividido
- Stingray
- Suva
- Svix
- Telstra
- Tencent
- A Universidade de Aizu
- Tinqin
- APS translúcido
- Plataforma de tempo de viagem
- Tribalscale
- Trifork
- Tui Infotec GmbH
- Twilio
- Twitter
- Unblu inc.
- VELO
- VMware
- Soluções WBT
- Woleet
- WSO2
- VoChary.io
- Xero
- Yahoo Japão
- Viadee
- Vonage
- Tecnologia Yitu
- Yelp
- Zalando
- 3DS Outcale
5 - Apresentações/Vídeos/Tutoriais/Livros
- 2018/05/12 - gerador Openapi - conduzido pela comunidade で成長するコードジェネレータ por 中野暁人
- 2018/05/05 - Iniciando um novo projeto de fonte aberta de Jeremie Bresson
- 2018/05/2
- 2018/06/20
- 2018/06/21 - Conecte seus aplicativos jhipster ao mundo das APIs com o OpenAPI e GRPC por Christophe Bornet no Jhipster Conf 2018
- 2018/06/20
- 2018/06/27 - Lições aprendidas com um projeto de código aberto que suporta mais de 30 linguagens de programação - William Cheng em LinuxCon + Conterecon + CloudOpen China 2018
- 2018/07/2
- 2018/08/20
- 2018/09/2
- 2018/10/31 - um invólucro de pacote de nó para o OpenApi -Generator
- 2018/11/03 - gerador Openapi + Golang + Flutter でアプリ開発 por Ryuichi Daigo
- 2018/11/15 - 基于 OpenApi3.0 的 Yaml 文件生成 java 代码的一次实践 por 焱魔王
- 2018/11/18 - Gerando código da biblioteca PHP do OpenApi por Lorna Jane no Lornajane Blog
- 2018/11/19 - Openapis está por toda parte por Jeremie Bresson (Unblu) no Eclipsecon Europe 2018
- 2018/12/09 - OpenApi -Generator をカスタマイズする方法 por @watiko
- 2019/01/03 - Chamando um serviço de arrogância do Apex usando o OpenApi -Generator por Mikkel Flindt Heisterberg
- 2019/01/2
- 2019/01/20 - Desenvolvimento de API contratual -primeiro com gerador Openapi e conexão por Anil Can Aydin
- 2019/01/20
- 2019/02/02 - 平静を保ち、コードを生成せよ 〜 OpenApi Generator 誕生の背景と軌跡 〜 por 中野暁人 em gunma.web #34 スキーマ駆動開発
- 2019/02/20
- 2019/02/20
- 2019/02/20
- 2019-03-07-OpenApi Generator で Bot de mola と Angular をタイプセーフに繋ぐ por Tomofumi chiba
- 2019-03-16-Uma rápida introdução ao Manual Openapi V3 por Vados em Vadosware
- 2019-03-25-Acesse qualquer serviço de descanso com o SAP S/4HANA Cloud SDK por Alexander Duemont
- 2019-03-25-gerador Openapi を試してみる por @amuyikam
- 2019-03-27-OpenApi3 を使ってみよう! Go 言語でクライアントとスタブの自動生成まで! por @Gold_Kou
- 2019-04-17-OpenApi によるスキーマファースト開発の実施サンプルと Cloud Run について por @yukey1031
- 2019-04-18-Como usar o OpenAPI3 para desenvolvedor de API (Rubykaigi 2019) por @ota42y em Rubykaigi 2019
- 2019-04-29-Um guia para iniciantes para geração de código para APIs REST (gerador Openapi) por William Cheng
- 2019-05-01-projete e gerar uma API REST da Swagger / OpenAPI em Java, Python, C# e muito mais por como
- 2019-05-17-Gere a API Rest Spring Boot usando Swagger/OpenAPI por Antonie Zafirov
- 2019-05-22-Rest Apis 代码生成指南 (gerador Openapi) de William Cheng, Xin Meng
- 2019-05-20
- 2019-06-24-Kubernetes clientes e Openapi Generator por William Cheng no Kubernetes Colaboration Summits Shanghai 2019
- 2019-06-28
- 2019-06-29
- 2019-07-04-API REST (OpenApi Generator) por William Cheng, 中野暁人, 和田拓朗
- 2019-07-08 - Gerador Openapi にコントリビュートしたら社名が載った話。 (CAM) - CAM TECH BLOG BY CAM, INC.
- 2019-07-14-gerador Openapi で python のクライアントライブラリを作成した por yuji38kwmt
- 2019-07-19-Desenvolvedor Experiência (DX) para projetos de código aberto: como envolver desenvolvedores e construir uma comunidade crescente de desenvolvedores por William Cheng, 中野暁人 no Open Source Summit Japan 2019
- 2019-08-14-Nossa jornada do Openapi com SDKs padronizando por Sebastian Burgstaller em Bitmovin
- 2019-08-15-API のコードを自動生成させたいだけなら GRPC でなくてもよくない? por M3, Inc.
- 2019-08-22-マイクロサービスにおける web api スキーマの管理 ─ graphql 、 grpc 、 openapi の特徴と使いどころ por @ota42y
- 2019-08-24-Swagger ドキュメントから OpenApi Generator を使ってモックサーバー作成 por 坂本正義
- 2019-08-29-OpenApi 初探 por Peakxie em 腾讯云社区
- 2019-08-29-全面进化 : Kubernetes CRD 1.16 Ga 前瞻 por Min Kim no ServiceMesher Blog
- 2019-09-01-Criando um servidor Php-Slim usando o OpenAPI (Vídeo do YouTube) por Daniel Persson
- 2019-09-06-Vert.x e Openapi de Stephan H Wissel no blog Wissel.net
- 2019-09-09-Desenvolvimento nativo da nuvem-Criando microsserviços RESTful em IBM Cloud Docs
- 2019-09-14-Gerando e configurando um cliente da API MasterCard na plataforma MasterCard Developers
- 2019-09-15-Openapi (Swagger) 導入下調べ Por Shoichi Kuraoka
- 2019-09-17-Tutorial: documentando APIs HTTP4K com o OpenAPI3 por HTTP4K
- 2019-09-22-Openapi 3 を完全に理解できる本 por @ota42y
- 2019-09-22-APIs RESTful: tutorial da especificação OpenAPI por Amir Lavasani
- 2019-09-22-Redefinindo os SDKs como kits de diversidade de software de Sid Maestre (Xero) no Devrelcon San Francisco 2019
- 2019-09-23-Swagger から OpenApi Generator で Spring のコードを自動生成 Por @Littlefeet em Qiita
- 2019-09-24-Eine Stunde foi o MIT API primeiro! Por @janweinschenker no Java Forum Nord
- 2019-10-09-OpenApi-gerador で生成した Go クライアントで Bearer 認証をする por Akira Tanimura
- 2019-10-10-Geração automática de clientes REST de Thomas Peyard, engenheiro de software sênior da Criteo em palestras de tecnologia de pilha completa (Meetup)
- 2019-10-12-OpenApi 自动生成 Cliente por 郑泽洲
- 2019-10-16-Como enviar APIs mais rápido? Por Simon Guilliams @ Ponicode
- 2019-10-22-OpenApi + Spring Boot (Kotlin) でファイルダウンロード API を作成する Por Yuki Furukawa
- 2019-10-24 - Microprofile OpenApi - Código primeiro ou Design primeiro? Por Peter [pɛʃə] Steiner em Eclipsecon Europe 2019
- 2019-11-06-Gerando clientes de API com base nas especificações do OpenAPI V3 de Dominik Jastrzębski @ 98Elements
- 2019-11-06-Openapi を利用して自前の API サーバー (Sinatra) を移植した時のメモ por Yasuhiro Abe
- 2019-11-07 - API First Development With OpenApi - Você deveria praticar!? Por Nick Van Hoof na Devoxx Bélgica 2019
- 2019-11-08-Jhipster além de Crud-API-First for Enterprises by Enrico Costanzi por Enrico Costanzi no Jhipster Conf 2019 em Paris
- 2019-11-11-API REST TypeScript クライアント Por @unhurried
- 2019-11-11 - Uma especificação para governar todos eles - OpenApi em ação de Andreas Litt em Code.Talks 2019
- 2019-11-13-Editor e gerador OpenApi 3.0 com um exemplo de inicialização da mola simplesmente como
- 2019-11-17-Lista de reprodução do gerador OpenAPI no YouTube
- 2019-11-20-Introdução ao Openapi por Lorna Mitchell no Goto Copenhagen 2019
- 2019-11-20-Como gerar código angular a partir de especificações do OpenAPI por Anuraj
- 2019-11-23-Swagger ではない OpenApi Specification 3.0 による API サーバー開発 Por Tetsuya Morimoto no Jjug CCC 2019 Fall
- 2019-11-20
- 2019-11-25-OpenApi-gerador で手軽にスタブサーバとクライアントの生成 por @Pochopocho13
- 2019-11-26-Destaques Cordacon 2019: servidor Braid e OpenAPI Gerator for CordA Client APIs por Adel Rustum no B9Lab
- 2019-12-03-Um caminho para menos codificação: Apilibrary automaticamente-generalizado no CORDA Blog
- 2019-12-04-Angular + Nestjs + Openapi (Swagger) でマイクロサービスを視野に入れた環境を考える por てらしー てらしー
- 2019-12-05-Geração de código na Java VM por Sean Sullivan
- 2019-12-17-gerador OpenApi で oauth2 アクセストークン発行のコードまで生成してみる por techscore
- 2019-12-23-Use a ADA para o seu desenvolvimento da web por Stephane Carrez
- 2019-12-23-OpenApi のスキーマを分割・構造化していく方法 por 小飯塚達也 em presente, Inc
- 2020-01-17-Demo OpenApi para Pulp 3,0 GA por Pulp no YouTube
- 2020-01-19-Por que documentar uma API REST como código? por Rolf Streefkerk na comunidade de desenvolvimento
- 2020-01-28-Retire sua arrogância sem servidor com o OpenApi por Matt Tyler
- 2020-01-30-gerador OpenApi へのコントリビュート por yutaka0m
- 2020-02-01-Usando o OpenAPI para maximizar sua experiência de polpa 3 por Dennis Kliban em Fosdem
- 2020-02-07-Por que você deve usar o OpenAPI para o seu design de API por Nick Van Hoof na API Conference
- 2020-02-17-Rubynetes: Usando o OpenAPI para validar as configurações de Kubernetes por Neil Wilson na Brightbox
- 2020-02-20-Construindo SDKs para o futuro por Sid Maestre (Xero)
- 2020-02-27-nuxt 利用プロダクトで ie11 と仲良くするための e2e em medpeer.co.jp Tech blog
- 2020-02-29-fornecendo suporte a dispositivos IoT implantados em ambiente rural desconectado (artigo da conferência) por Sergio Laso, Daniel Flores-Martín, Juan Luis Herreracarlos, Canaljuan Manuel, Murillojavier Berrocal
- 2020-03-02-Como gerar código Angular e Spring a partir de especificação OpenApi por Michael Hoffmann
- 2020-03-02-gerador OpenAPI + TypeScript で始める自動生成の型に守られた豊かなクライアント生活 por 五百蔵 直樹 em presente 株式会社
- 2020-03-10-Openapi Generator Meetup #1 por 中野暁人 no Openapi Generator Meetup #1
- 2020-03-15-Carregar testando sua API com Swagger/OpenAPI e K6
- 2020-04-13-俺的【 Oas 】との向き合い方 (爆速で OpenApi と友達になろう) no blog Optim
- 2020-04-22-Introdução ao gerador Openapi por Kristopher Sandoval em APIs Nórdicas
- 2020-04-27-Como usamos a especificação aberta da API V3 para documentação da API, snippets de código e clientes por Tanel Tähepõld
- 2020-05-09-Openapi でお手軽にモック API サーバーを動かす por Sachie Kamba
- 2020-05-18-Spring Boot Rest With OpenApi 3 por Alfonz Jan Frithz
- 2020-05-19-APIs simples mortas com API Open de Chris Tankersley no Nexmo
- 2020-05-22-Cliente da API REST TypeScript por "sem pressa"
- 2020-05-28 - 【使用 Lotify + Swagger 建置可 用的用的 Notificar BOT】 - #nijia @ Desenvolvedor de chatbot Taiwan 第 #19 小聚 Por Chatbot Developer Taiwan
- 2020-05-28-APIs de construção com Laravel usando o Openapi por Chris Tankersley na Laracon EU
- 2020-06-12-Interoperabilidade por construção: Geração de código para clientes de Arrowhead por Michele Albano, Brian Nielsen na 2020 IEEE Conference sobre sistemas ciberfísicos industriais (ICPS)
- 2020-06-23-新規サーバーアプリケーションに TypeScript を採用してみた no CAM Tech Blog
- 2020-06-29-Resumo do artefato: Implantação de APIs em dispositivos móveis e microcontroladores Android por Sergio Laso; Marino Linaje; Jose Garcia-Alonso; Juan M. Murillo; Javier Berrocal na Conferência Internacional de 2020 IEEE sobre Computação e Comunicações Pervasivas (PERCOM)
- 2020-07-07-5 Melhores ferramentas de documentação da API de Susanna Bouse no DreamFactory Blog
- 2020-07-12-API aberto 3.0 の定義から Golang のサーバコードのスケルトンを作成する Por @professor (blog Qiita)
- 2020-07-20-Bibliotecas de clientes da API Datadog agora disponíveis para Java e Go By Jordan Obey no Datadog Blog
- 2020-07-23-Gere o cliente SDK para .NET Core usando API Open por Nuno Reis
- 2020-07-26-Dart の http_intercept ライブラリを使うと配列のクエリパラメータが消えてしまう件の応急処置 por @gyamoto
- 2020-08-01-Gere formas reativas angulares de Swagger/OpenApi por Martin McWhorter
- 2020-08-03-Criando Bibliotecas para Apis Restful Com OpenApi, editor de swagger E Openapi Generator por Everis Brasil (uma empresa de dados da NTT)
- 2020-08-19-マイクロサービスを連携してみよう por 岡井 裕矢 (おかい ゆうや ゆうや), 泉 勝 (いずみ まさる まさる) em Think It (シンクイット)
- 2020-08-25-OpenApi Generator と TypeScript で型安全にフロントエンド開発をしている話 no Smarthr Tech Blog
- 2020-09-10-Introdução ao OpenApi com Instana por Cedric Ziel no Instana Blog
- 2020-09-17-Gere PowerShellsdk usando o OpenApi-Generator por Ghufran Zahidi
- 2020-09-24 - Como automatizar a geração de código da API (Openapi/Swagger) e Boost Productivity - Tutorial com o React Native com TypeScript de Sanjin Celeski
- 2020-09-25-Gere OpenApi Angular Client por Patric
- 2020-10-24 - Trabalhando com a Microsoft Identity - React Native Client por Joseph Guadagno
- 2020-10-31-[B2] Especificação OpenApi 으로 타입-세이프하게 API 개발하기: 희망편 vs 절망편 por 최태건 em Feconf 2020
- 2020-11-05-Geração automatizada de código REST-API: Wie It-Systeme Miteinander Sprechen por Stefan Rottenteiner no Blog de Arte Massiva
- 2020-12-01-gerador OpenApi で GO の API サーバー/クライアントコードを自動生成する por @saki-engenharia
- 2020-12-04-Escalando a cobertura de teste do gerador OpenAPI para mais de 30 linguagens de programação de William Cheng no Open Source Summit Japan + Automotive Linux Summit 2020 (slides)
- 2020-12-09-プロジェクトに OpenApi Generator で自動生成された型付き API Client を導入した話 Por @yoshifujit
- 2020-12-15-Next.js + Nestjs + graphql で変化に追従するフロントエンドへ 〜 ショッピングクーポンの事例紹介 por 小倉 陸 no yahoo! Blog de tecnologia do Japão
- 2021-01-08-Olá, nova API-Parte 1 por Jeremy Schulman na Major League Baseball
- 2021-01-18-「アプリ開発あるある」を疑うことから始まった、 API Client コードの自動生成【デブスト 2020】 por codezine 編集部
- 2021-02-05-Trip de Rest-Api-Round com Springdoc e Openapi Generator por Benjamin Klatt em Viadee
- 2021-02-17-Rest-Api-Roundtrip com Springdoc e Openapi Generator by Cloud @viDee
- 2021-03-08-gerador OpenApi 工具的躺坑尝试 por 独家雨天 em csdn 官方博客
- 2021-03-16-如何基于 Swagger 使用 OpenApi Generator 生成 JMeter 脚本? por 高楼 Zee em 腾讯云专栏
- 2021-03-24-OpenApi-gerador-cli による TypeScript 型定義 Por Takefumi Yoshii
- 2021-03-28-Experimentando o Nestjs Parte 4: Gere clientes digitados a partir de documentos OpenAPI por Arnaud Cortisse
- 2021-03-31-Open API Server Implementation usando o Openapi Generator em Baeldung
- 2021-03-31-使用 OpenApi Generator 實現 Open API Server em 億聚網
- 2021-04-2
- 2021-04-22-Aproveitando os pontos fortes do OpenAPI em um ambiente de micro-serviço por Nicolas Jellab no Unibuddy Technology Blog
- 2021-04-27-De zero à publicação PowerShell API Clients in PowerShell Gallery em poucos minutos por William Cheng no PowerShell + DevOps Global Summit 2021
- 2021-05-31-Flutter で Open API Generator (Swagger) を使う por Aakira
- 2021-06-22-Documentação da API REST e geração de clientes com o OpenAPI por Prasanth Gullapalli
- 2021-07-16 - 銀行事業のサーバーサイド開発について / LINE 京都開発室 エンジニア採用説明会 by 野田誠人, Robert Mitchell
- 2021-07-19 - OpenAPI code generation with kotlin by sylhare
- 2021-07-29 - How To Rewrite a Huge Codebase by Curtis Poe
- 2021-08-21 - Generating Client APIs using Swagger Part 1 by FlowSquad.io
- 2021-09-11 - Invoking AWS ParallelCluster API at AWS ParallelCluster API official documentation
- 2021-09-20 - OpenAPI Generator - The Babel Fish of the API World by Cliffano Subagio (Principal Engineer at Shine Solutions) at Apidays LIVE Australia 2021
- 2021-10-02 - How to Write Fewer Lines of Code with the OpenAPI Generator by Mikhail Alfa
- 2021-10-12 - OpenAPI Generator : 4000 étoiles sur GitHub et des spaghettis by Jérémie Bresson at Devoxx FR 2021
- 2021-10-17 - Generate a TypeScript HTTP Client From An OpenAPI Spec In DotNET 5 by Richard Willis
- 2021-11-06 - スタートアップの開発で意識したこと by woo-noo
- 2021-11-09 - Effective Software Development using OpenAPI Generator by Ajil Oomme
- 2021-12-07 - An Introduction to OpenAPI by Na'aman Hirschfeld
- 2022-01-02 - Towards a secure API client generator for IoT devices by Anders Aaen Springborg, Martin Kaldahl Andersen, Kaare Holland Hattel, Michele Albano
- 2022-02-02 - Use OpenApi generator to share your models between Flutter and your backend by Guillaume Bernos at Flutter Vikings Conference 2022 (Hybrid)
- 2022-03-15 - OpenAPI Specでハイフン区切りのEnum値をOpenAPI Generatorで出力すると、ハイフン区切りのまま出力される by yuji38kwmt
- 2022-04-01 - OpenAPI Generatorのコード生成とSpring Frameworkのカスタムデータバインディングを共存させる in ZOZO Tech Blog
- 2022-04-06 - Effective Software Development using OpenAPI Generator by Ajil Oommen (Senior Flutter Developer)
- 2022-05-13 - A Path From an API To Client Libraries by Filip Srnec at Infobip
- 2022-06-01 - API First, using OpenAPI and Spring Boot by Micael Estrázulas Vianna
- 2022-06-10 - Autogenerating Clients with FastAPI and Github Actions by Andrew Israel
- 2022-06-12 - Mustache templates with OpenAPI specs by Beppe Catanese
- 2022-07-01 - Generate API contract using OpenAPI Generator Maven plugin by Khanh Nguyen
- 2022-07-22 - 使用OpenAPI Generator Maven plugin开发api优先的java客户端和服务端代码 by Lincest
- 2022-08-01 - Tutorial: Etsy Open API v3 (ruby) by Thierry Joyal
- 2022-09-03 - OpenAPI Generator For Go Web Development by Kevin Hu
- 2022-10-01 - OpenAPI Generatorをカスタマイズしたコードを生成する(Swagger Codegenとほぼ同じ) by きり丸
- 2022-10-21 - Kotlin(Spring Boot)の API を OpenAPI Generator で自動生成 by msksgm
- 2022-10-26 - Quarkus Insights #106: Quarkiverse Extension Spotlight: OpenApi Generator by Quarkusio
- 2022-11-28 - The REST API implementation flow by Imre Tömösvári
- 2022-12-13 - API-First with Spring WebFlux and OpenAPI Generator by Eric Anicet
- 2023-01-06 - Major Improvements with Helidon and OpenAPI by Tim Quinn
- 2023-02-02 - Replacing Postman with the Jetbrains HTTP Client by julien Lengrand-Lambert
- 2023-03-15 - OpenAPI Generatorに適したOpenAPIの書き方 by ZOZO Tech Blog
- 2023-03-19 - EXOGEM: Extending OpenAPI Generator for Monitoring of RESTful APIs by Daniel Friis Holtebo, Jannik Lucas Sommer, Magnus Mølgaard Lund, Alessandro Tibo, Junior Dongo & Michele Albano at "ICSOC 2022: Service-Oriented Computing – ICSOC 2022 Workshops "
- 2023-03-28 - API-First Design with OpenAPI Generator by Jonathan Manera
- 2023-03-28 - ハンズオンで学ぶサーバーサイド Kotlin(Spring Boot&Arrow&OpenAPI Generator)v1.0.1 by msk
- 2023-04-01 - OpenAPI Client Code Generation by Kwo Ding
- 2023-04-27 - [Create an Angular Client using OpenAPI Specifications](Create an Angular Client using OpenAPI Specifications) by Patric
- 2023-05-16 - Adyen for Java developers by Beppe Catanese, Developer Advocate, Adyen
- 2023-05-18 - 如何基于 Swagger 使用 OpenAPI Generator 生成 JMeter 脚本? by 高楼(Zee)
- 2023-06-28 - Generate API contract using OpenAPI Generator Maven plugin by Khanh Nguyen
- 2023-06-30 - Generate Client SDKs with OpenApi Generator in Springboot by Vinayak Ramavath
- 2023-12-10 - UnityでOpenAPI Generatorを使う by Soup Tori
- 2024-01-24 - Comment générer des stubs wiremock avec openapi generator by Alexis Couvreur
- 2024-03-04 - Generating TypeScript Types with OpenAPI for REST API Consumption by PullRequest
- 2024-03-07 - Fully typed Web Apps with OpenAPI (Part 1) by Guillaume Renard
- 2024-03-08 - Laravel OpenAPIによる "辛くない" スキーマ駆動開発 by KentarouTakeda
6 - About Us
What's the design philosophy or principle behind OpenAPI Generator?
We focus on developer experience. The generators should produce code, config, documentation, and more that are easily understandable and consumable by users. We focused on simple use cases to start with (bottom-up approach). Since then the project and the community have grown a lot: 600k weekly downloads via NPM CLI wrapper, 30M downloads via openapi-generator-cli docker image just to highlight a few. We've gradually supported more features (eg oneOf, anyOf introduced in OpenAPI 3.0) in various generators and we will continue this approach to deliver something based on our understanding of user demand and what they want, and continue to add support of new features introduced in OpenAPI specification (such as v3.1 and future versions of the OpenAPI specification).
6.1 - OpenAPI Generator Core Team
OpenAPI Generator core team members are contributors who have been making significant contributions (review issues, fix bugs, make enhancements, etc) to the project on a regular basis.
Core Team Members
- @wing328 (2015/07) ❤️
- @jimschubert (2016/05) ❤️
- @cbornet (2016/05)
- @jmini (2018/04) ❤️
- @etherealjoy (2019/06)
❤️ = Link to support the contributor directly
Template Creator
NOTE : Embedded templates are only supported in Mustache format. Support for all other formats is experimental and subject to change at any time.
Here is a list of template creators:
- API Clients:
- Ada: @stcarrez
- Apex: @asnelling
- Bash: @bkryza
- C: @PowerOfCreation @zhemant ❤️
- C++ REST: @Danielku15
- C++ Tiny: @AndersSpringborg @kaareHH @michelealbano @mkakbas
- C++ UE4: @Kahncode
- C# (.NET 2.0): @who
- C# (.NET Standard 1.3 ): @Gronsak
- C# (.NET 4.5 refactored): @jimschubert ❤️
- C# (GenericHost): @devhl-labs
- C# (HttpClient): @Blackclaws
- Clojure: @xhh
- Crystal: @wing328
- Dart: @yissachar
- Dart (refactor): @joernahrens
- Dart 2: @swipesight
- Dart (Jaguar): @jaumard
- Dart (Dio): @josh-burton
- Elixir: @niku
- Elm: @eriktim
- Eiffel: @jvelilla
- Erlang: @tsloughter
- Erlang (PropEr): @jfacorro @robertoaloi
- Groovy: @victorgit
- Go: @wing328 ❤️
- Go (rewritten in 2.3.0): @antihax
- Godot (GDScript): @Goutte ❤️
- Haskell (http-client): @jonschoning
- Java (Feign): @davidkiss
- Java (Retrofit): @0legg
- Java (Retrofit2): @emilianobonassi
- Java (Jersey2): @xhh
- Java (okhttp-gson): @xhh
- Java (RestTemplate): @nbruno
- Java (Spring 5 WebClient): @daonomic
- Java (Spring 6 RestClient): @nicklas2751
- Java (RESTEasy): @gayathrigs
- Java (Vertx): @lopesmcc
- Java (Google APIs Client Library): @charlescapps
- Java (Rest-assured): @viclovsky
- Java (Java 11 Native HTTP client): @bbdouglas
- Java (Apache HttpClient 5.x): @harrywhite4 @andrevegas
- Java (Helidon): @spericas @tjquinno @tvallin
- Javascript/NodeJS: @jfiala
- JavaScript (Apollo DataSource): @erithmetic
- JavaScript (Closure-annotated Angular) @achew22
- JavaScript (Flow types) @jaypea
- Jetbrains HTTP Client : @jlengrand
- JMeter: @davidkiss
- Julia: @tanmaykm
- Kotlin: @jimschubert ❤️
- Kotlin (MultiPlatform): @andrewemery
- Kotlin (Volley): @alisters
- Kotlin (jvm-spring-webclient): @stefankoppier
- Kotlin (jvm-spring-restclient): @stefankoppier
- Lua: @daurnimator
- N4JS: @mmews-n4
- Nim: @hokamoto
- OCaml: @cgensoul
- Perl: @wing328 ❤️
- PHP (Guzzle): @baartosz
- PHP (with Data Transfer): @Articus
- PowerShell: @beatcracker
- PowerShell (refactored in 5.0.0): @wing328
- Python: @spacether [:heart:][spacether sponsorship]
- Python-Experimental: @spacether [:heart:][spacether sponsorship]
- Python (refactored in 7.0.0): @wing328
- R: @ramnov
- Ruby (Faraday): @meganemura @dkliban
- Ruby (HTTPX): @honeyryderchuck
- Rust: @farcaller
- Rust (rust-server): @metaswitch
- Scala (scalaz & http4s): @tbrown1979
- Scala (Akka): @cchafer
- Scala (sttp): @chameleon82
- Scala (sttp4): @flsh86
- Scala (Pekko): @mickaelmagniez
- Scala (http4s): @JennyLeahy
- Swift: @tkqubo
- Swift 3: @hexelon
- Swift 4: @ehyche
- Swift 5: @4brunu
- Swift 6: @4brunu
- Swift Combine: @dydus0x14
- TypeScript (Angular1): @mhardorf
- TypeScript (Angular2): @roni-frantchi
- TypeScript (Angular6): @akehir
- TypeScript (Angular7): @topce
- TypeScript (Axios): @nicokoenig
- TypeScript (Fetch): @leonyu
- TypeScript (Inversify): @gualtierim
- TypeScript (jQuery): @bherila
- TypeScript (Nestjs): @vfrank66
- TypeScript (Node): @mhardorf
- TypeScript (Rxjs): @denyo
- TypeScript (redux-query): @petejohansonxo
- Xojo: @Topheee
- Zapier: @valmoz, @emajo
- Server Stubs
- Ada: @stcarrez
- C# ASP.NET 5: @jimschubert ❤️
- C# ASP.NET Core 3.0: @A-Joshi
- C# APS.NET Core 3.1: @phatcher
- C# Azure functions: @Abrhm7786
- C# NancyFX: @mstefaniuk
- C++ (Qt5 QHttpEngine): @etherealjoy
- C++ Pistache: @sebymiano
- C++ Restbed: @stkrwork
- Erlang Server: @galaxie @nelsonvides
- F# (Giraffe) Server: @nmfisher
- Go Server: @guohuang
- Go Server (refactored in 7.0.0): @lwj5
- Go (Echo) Server: @ph4r5h4d
- Go (Gin) Server: @kemokemo
- GraphQL Express Server: @renepardon
- Haskell Servant: @algas
- Haskell Yesod: @yotsuya
- Java Camel: @carnevalegiacomo
- Java MSF4J: @sanjeewa-malalgoda
- Java Spring Boot: @diyfr
- Java Undertow: @stevehu
- Java Play Framework: @JFCote
- Java PKMST: @anshu2185 @sanshuman @rkumar-pk @ninodpillai
- Java Vert.x: @lwlee2608
- Java Micronaut: @andriy-dmytruk
- Java Helidon: @spericas @tjquinno @tvallin
- Java WireMock: @acouvreur
- JAX-RS RestEasy: @chameleon82
- JAX-RS CXF: @hiveship
- JAX-RS CXF (CDI): @nickcmaynard
- JAX-RS RestEasy (JBoss EAP): @jfiala
- Julia: @tanmaykm
- Kotlin: @jimschubert ❤️
- Kotlin (Spring Boot): @dr4ke616
- Kotlin (Vertx): @Wooyme
- Kotlin (JAX-RS): @anttileppa
- Kotlin WireMock: @stefankoppier
- NodeJS Express: @YishTish
- PHP Flight: @daniel-sc
- PHP Laravel: @renepardon
- PHP Lumen: @abcsun
- PHP Mezzio (with Path Handler): @Articus
- PHP Slim: @jfastnacht
- PHP Slim4: @ybelenko
- PHP Symfony: @ksm2
- PHP Symfony6: @BenjaminHae
- Python FastAPI: @krjakbrjak
- Python AIOHTTP:
- Ruby on Rails 5: @zlx
- Rust (rust-server): @metaswitch
- Scala Akka: @Bouillie
- Scala Cask: @aaronp
- Scala Finch: @jimschubert ❤️
- Scala Lagom: @gmkumar2005
- Scala Play: @adigerber
- Documentação
- AsciiDoc: @man-at-home
- HTML Doc 2: @jhitchcock
- Confluence Wiki: @jhitchcock
- PlantUML: @pburls
- Configuração
- Apache2: @stkrwork
- k6: @mostafa
- Esquema
- Avro: @sgadouar
- GraphQL: @wing328 ❤️
- Ktorm: @Luiz-Monad
- MySQL: @ybelenko
- Postman Collection: @gcatanese
- Protocol Buffer: @wing328
- WSDL: @adessoDpd
❤️ = Link to support the contributor directly
How to join the core team
Here are the requirements to become a core team member:
- rank within top 50 in https://github.com/openapitools/openapi-generator/graphs/contributors
- to contribute, here are some good starting points
- regular contributions to the project
- about 3 hours per week
- for contribution, it can be addressing issues, reviewing PRs submitted by others, submitting PR to fix bugs or make enhancements, etc
- must be active in the past 3 months at the time of application
To join the core team, please reach out to [email protected] for more information.
To become a Template Creator, simply submit a PR for new API client (eg Rust, Elixir) or server stub (eg Ruby Grape) generator.
6.2 - OpenAPI Generator Technical Committee
Members of the OpenAPI Generator technical committee shoulder the following responsibilities:
- Provides guidance and direction to other users
- Reviews pull requests and issues
- Improves the generator by making enhancements, fixing bugs or updating documentations
- Sets the technical direction of the generator
Who is eligible? Those who want to join must have at least 3 PRs merged into a generator. (Exceptions can be granted to template creators or contributors who have made a lot of code changes with less than 3 merged PRs)
If you want to join the committee, please kindly apply by sending an email to [email protected] with your Github ID.
Members of Technical Committee
Languages/Generators | Member (join date) |
---|
ActionScript | |
Ada | @stcarrez (2018/02) @michelealbano (2018/02) |
Android | @jaz-ah (2017/09) |
Ápice | |
Bash | @frol (2017/07) @bkryza (2017/08) @kenjones-cisco (2017/09) |
C | @zhemant (2018/11) @ityuhui (2019/12) @michelealbano (2020/03) |
C ++ | @ravinikam (2017/07) @stkrwork (2017/07) @etherealjoy (2018/02) @martindelille (2018/03) @muttleyxd (2019/08) |
C# | @mandrean (2017/08) @shibayan (2020/02) @Blackclaws (2021/03) @lucamazzanti (2021/05) @iBicha (2023/07) |
Clojure | |
Cristal | @cyangle (2021/01) |
Dardo | @jaumard (2018/09) @josh-burton (2019/12) @amondnet (2019/12) @sbu-WBT (2020/12) @kuhnroyal (2020/12) @agilob (2020/12) @ahmednfwela (2021/08) |
Eiffel | @jvelilla (2017/09) |
Elixir | @mrmstn (2018/12) |
Olmo | @eriktim (2018/09) |
Erlang | @tsloughter (2017/11) @jfacorro (2018/10) @robertoaloi (2018/10) @nelsonvides (2024/09) |
F# | @nmfisher (2019/05) |
Ir | @antihax (2017/11) @grokify (2018/07) @kemokemo (2018/09) @jirikuncar (2021/01) @ph4r5h4d (2021/04) @lwj5 (2023/04) |
GraphQL | @renepardon (2018/12) |
Groovy | |
Haskell | |
Java | @bbdouglas (2017/07) @sreeshas (2017/08) @jfiala (2017/08) @lukoyanov (2017/09) @cbornet (2017/09) @jeff9finger (2018/01) @karismann (2019/03) @Zomzog (2019/04) @lwlee2608 (2019/10) @martin-mfg (2023/08) |
Java Spring | @cachescrubber (2022/02) @welshm (2022/02) @MelleD (2022/02) @atextor (2022/02) @manedev79 (2022/02) @javisst (2022/02) @borsch (2022/02) @banlevente (2022/02) @Zomzog (2022/09) @martin-mfg (2023/08) |
JMeter | @kannkyo (2021/01) |
Jetbrains HTTP Client | @jlengrand (2023/01) |
Julia | @tanmaykm (2023/01) |
Kotlin | @dr4ke616 (2018/08) @karismann (2019/03) @Zomzog (2019/04) @andrewemery (2019/10) @4brunu (2019/11) @yutaka0m (2020/03) @stefankoppier (2022/06) @e5l (2024/10) |
Lua | @daurnimator (2017/08) |
N4JS | @mmews-n4 (2023/03) |
Nim | |
NodeJS/Javascript | @CodeNinjai (2017/07) @frol (2017/07) @cliffano (2017/07) |
ObjC | |
OCAML | @cgensoul (2019/08) |
Perl | @wing328 (2017/07) ❤️ @yue9944882 (2019/06) |
Php | @jebentier (2017/07), @dkarlovi (2017/07), @mandrean (2017/08), @jfastnacht (2017/09), @ybelenko (2018/07), @renepardon (2018/12) |
Powershell | @wing328 (2020/05) |
Python | @cbornet (2017/09) @tomplus (2018/10) @krjakbrjak (2023/02) @fa0311 (2023/10) @multani (2023/10) |
R | @Ramanth (2019/07) @saigiridhar21 (2019/07) |
Rubi | @cliffano (2017/07) @zlx (2017/09) @autopp (2019/02) |
Ferrugem | @frol (2017/07) @farcaller (2017/08) @richardwhiuk (2019/07) @paladinzh (2020/05) @jacob-pro (2022/10) |
Scala | @clasnake (2017/07), @shijinkui (2018/01), @ramzimaalej (2018/03), @chameleon82 (2020/03), @Bouillie (2020/04) @fish86 (2023/06) |
Swift | @jgavris (2017/07) @ehyche (2017/08) @Edubits (2017/09) @jaz-ah (2017/09) @4brunu (2019/11) @dydus0x14 (2023/06) |
TypeScript | @TiFu (2017/07) @taxpon (2017/07) @sebastianhaas (2017/07) @kenisteward (2017/07) @Vrolijkx (2017/09) @macjohnny (2018/01) @topce (2018/10) @akehir (2019/07) @petejohansonxo (2019/11) @amakhrov (2020/02) @davidgamero (2022/03) @mkusaka (2022/04) @joscha (2024/10) |
Xojo | @Topheee (2023/04) |
Past Members of Technical Committee:
Languages/Generators | Member (join date) |
---|
Python | @taxpon (2017/07) @frol (2017/07) @mbohlool (2017/07) @cbornet (2017/09) @kenjones-cisco (2017/11) @tomplus (2018/10) @arun-nalla (2019/11) |
❤️ = Link to support the contributor directly
6.3 - History of OpenAPI Generator
OpenAPI Generator is a fork of Swagger Codegen. In view of the issues with the Swagger Codegen 3.0.0 (beta) release and the disagreement on the project's direction, more than 40 top contributors and template creators of Swagger Codegen decided to fork Swagger Codegen and maintain a community-driven version called "OpenAPI Gerador". Please refer to the Q&A for more information.
Founding Members (alphabetical order):
- Akihito Nakano
- Artem Ocheredko
- Arthur Mogliev
- Bartek Kryza
- Ben Wells
- Benjamin Gill
- Christophe Bornet
- Cliffano Subagio
- Daiki Matsudate
- Daniel
- Emiliano Bonassi
- Erik Timmers
- Esteban Gehring
- Gustavo Paz
- Javier Velilla
- Jean-François Côté
- Jim Schubert
- Jon Schoning
- Jérémie Bresson ❤️
- Jörn Ahrens
- Keni Steward
- Marcin Stefaniuk
- Martin Delille
- Masahiro Yamauchi
- Michele Albano
- Ramzi Maalej
- Ravindra Nikam
- Ricardo Cardona
- Sebastian Haas
- Sebastian Mandrean
- Sreenidhi Sreesha
- Stefan Krismann
- Stephane Carrez
- Takuro Wada
- Tomasz Prus
- Tristan Sloughter
- Victor Orlovsky
- Victor Trakhtenberg
- Vlad Frolov
- Vladimir Pouzanov
- William Cheng
- Xin Meng ❤️
- Xu Hui Hui
- antihax
- beatcracker
- daurnimator
- etherealjoy
- jfiala
- lukoyanov
❤️ = Link to support the contributor directly
7 - License
Copyright 2018 OpenAPI-Generator Contributors (https://openapi-generator.tech) Copyright 2018 SmartBear Software
Licenciado sob a licença Apache, versão 2.0 (a "licença"); Você não pode usar esse arquivo, exceto em conformidade com a licença. You may obtain a copy of the License at apache.org/licenses/LICENSE-2.0
A menos que exigido pela lei aplicável ou acordada por escrito, o software distribuído pela licença é distribuído "como está", sem garantias ou condições de qualquer tipo, expressa ou implícita. Consulte a licença para o idioma específico que rege as permissões e limitações sob a licença.