Descarga openapi generator - Descargar el código fuente openapi generator

Generador de Openapi

Maestro ( 7.11.0 ):

Si desea contribuir, consulte las pautas y una lista de tareas abiertas.

‼ ️ Para migrar de Swagger Codegen a OpenApi Generator, consulte la Guía de migración ‼ ️

? Para obtener más información, consulte la página Wiki y las preguntas frecuentes.

? ¿El libro electrónico es una guía para principiantes para la generación de código para las API REST es un buen punto de partida para principiantes?

️ Si la especificación de OpenApi, las plantillas o cualquier entrada (por ejemplo, las opciones, variables de entorno) se obtiene de una fuente o entorno no confiable, asegúrese de que haya revisado estas entradas antes de usar el generador de OpenApi para generar el cliente API, el estiramiento del servidor o la documentación para evitar Problemas de seguridad potenciales (por ejemplo, inyección de código). Para las vulnerabilidades de seguridad, comuníquese con [email protected]. ️

‼ ️ Tanto "Herramientas OpenApi" (https://openapitools.org: la organización matriz de OpenApi Generator) y "OpenApi Generator" no están afiliados a OpenAPI Initiative (OAI) ‼ ️

Patrocinadores

Si encuentra útil el generador de OpenApi para el trabajo, considere pedirle a su empresa que apoye este proyecto de código abierto convirtiéndose en patrocinador. También puede patrocinar individualmente el proyecto convirtiéndose en un patrocinador.

¡Gracias a nuestros patrocinadores de bronce!

Gracias Godaddy por patrocinar los nombres de dominio, Linode por patrocinar a los VPS, para patrocinar el monitoreo de API y graduarse por patrocinadores de la desarrollo

Descripción general

OpenAPI Generator permite la generación de bibliotecas de clientes API (generación SDK), trozos de servidor, documentación y configuración automáticamente dada una especificación de OpenAPI (se admiten tanto 2.0 como 3.0). Actualmente, se admiten los siguientes idiomas/marcos:

	Idiomas/marcos
Clientes de API	ActionScript , Ada , Apex , Bash , C , C# (.NET 2.0, 3.5 o posterior, .NET Standard 1.3 - 2.1, .NET Core 3.1, .NET 5.0. Bibliotecas: Restsharp, Genericost, HttpClient), C ++ (Arduino, -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, finign, rest stemplate, resteasy, vertx, biblioteca de clientes de la API de Google para java, asuntos de descanso, spring 5 web cliente, resorte 6 restclient, cliente de descanso microprofile, Helidon, Helidon, Helid ), Cliente http http , Julia , K6 , Kotlin , Lua , N4JS , Nim , Node.js/JavaScript (ES5, ES6, AngularJS con anotaciones de compiladores de cierre de Google, tipos de flujo, almacén de datos de Apolo Graphql), Objective-C , Ocaml , Perly , 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), WysteScript (AngularJS, Angular (9.x - 18.x), Aurelia, Axios, Fetch, Inversify, JQuery, Nestjs, Node, Redux -Query, RXJS), Xojo , Zapier
Trastos de servidor	ADA , C# (ASP.NET Core, Azure Functions), C ++ (Pistache, Restbed, Qt5 QhttpEngine), Erlang , F# (javafe), GO (net/http, gin, echo), Haskell (Servant, Yesod), Java (Java (Java (Java (Java (Java ( MSF4J, Spring, Untow, 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 Expresivo), Slim, Silex, Symfony), Python (Fastapi, Flask), NodeJs , Ruby (Sinatra, Rails5), Rust (Rust-Server), Scala (Akka, Finch, Finch, Lagom, Play, Cancisco, Scalatra)
Generadores de documentación de API	HTML , Confluence Wiki , Asciidoc , Markdown , Plantuml
Archivos de configuración	Apache2
Otros	Graphql , JMeter , KTorm , MySQL Schema , Postman Collection , Protocol Buffer , WSDL

Tabla de contenido

Generador de Openapi
Descripción general
Tabla de contenido
1 - Instalación
- 1.1 - Compatibilidad
- 1.2 - Artifactos en Maven Central
- 1.3 - Descargar jar
- 1.4 - Construir proyectos
- 1.5 - Homebrew
- 1.6 - Docker
- 1.7 - NPM
2 - Empezando
3 - Uso
- 3.1 - Personalización
- 3.2 - Integración de flujo de trabajo
- 3.3 - Generadores en línea
- 3.4 - Información de licencia sobre el código generado
- 3.5 - Integración IDE
4 - Empresas/proyectos que utilizan el generador OpenAPI
5 - Presentaciones/videos/tutoriales/libros
6 - Sobre nosotros
- 6.1 - Openapi Generator Core Team
- 6.2 - Comité Técnico del Generador de OpenAPI
- 6.3 - Historia del generador de OpenApi
7 - Licencia

1 - Instalación

1.1 - Compatibilidad

La especificación de OpenAPI ha sufrido 3 revisiones desde la creación inicial en 2010. El proyecto OpenApi-Generator tiene las siguientes compatibilidades con la especificación de OpenAPI:

Versión del generador de Openapi	Fecha de lanzamiento	Notas
7.11.0 (próxima versión menor) instantánea	20.12.2024	Liberación menor con cambios de ruptura (con alojamiento)
7.10.0 (último lanzamiento estable)	18.11.2024	Liberación menor con cambios de ruptura (con alojamiento)
6.6.0	11.05.2023	Liberación menor con cambios de ruptura (con alojamiento)
5.4.0	31.01.2022	Liberación menor con cambios de ruptura (con alojamiento)
4.3.1	06.05.2020	Liberación de parche (mejoras, correcciones de errores, etc.)

Compatibilidad con especificaciones de OpenAPI: 1.0, 1.1, 1.2, 2.0, 3.0, 3.1 (soporte beta)

(No publicamos la construcción diaria/nocturna. Utilice la instantánea en su lugar)

Para versiones antiguas, consulte la página de lanzamiento .

Para generadores/bibliotecas/marcos descomisados, consulte la etiqueta de "Desmisión" en la página de solicitud de extracción.

1.2 - Artifactos en Maven Central

Puede encontrar nuestros artefactos lanzados en Maven Central:

Centro:

< dependency >
    < groupId >org.openapitools</ groupId >
    < artifactId >openapi-generator</ artifactId >
    < version >${openapi-generator-version}</ version >
</ dependency >

Vea las diferentes versiones del artefacto de Generator OpenApi disponible en Maven Central.

CLI:

< dependency >
    < groupId >org.openapitools</ groupId >
    < artifactId >openapi-generator-cli</ artifactId >
    < version >${openapi-generator-version}</ version >
</ dependency >

Vea las diferentes versiones del artefacto de OpenApi-Generator-CLI disponible en Maven Central.

Maven Plugin:

< dependency >
    < groupId >org.openapitools</ groupId >
    < artifactId >openapi-generator-maven-plugin</ artifactId >
    < version >${openapi-generator-version}</ version >
</ dependency >

Consulte las diferentes versiones del artefacto de plugin-Generator-Generator-Generator disponible en Maven Central.
Readme

Plugin de graduación:

< dependency >
    < groupId >org.openapitools</ groupId >
    < artifactId >openapi-generator-gradle-plugin</ artifactId >
    < version >${openapi-generator-version}</ version >
</ dependency >

Vea las diferentes versiones del artefacto de plugin-Generator-Gradle-plugin de OpenApi-Generator disponibles en Maven Central.
Readme

1.3 - Descargar jar

Si está buscando la última versión estable, puede obtenerla directamente de maven.org (tiempo de ejecución de Java 11 como mínimo):

Ubicación del frasco: https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/7.10.0/openapi-generator-cli-7.10.0.jar

Para usuarios de Mac/Linux :

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

Para los usuarios de Windows , deberá instalar WGet o puede usar Invoke-WebRequest en 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

Después de descargar el jar, ejecute java -jar openapi-generator-cli.jar help para mostrar el uso.

Para los usuarios de Mac, asegúrese de que Java 11 esté instalado (consejos: ejecute java -version para verificar la versión) y exportar JAVA_HOME para usar la versión Java compatible:

 export JAVA_HOME= ` /usr/libexec/java_home -v 1.11 `
export PATH= ${JAVA_HOME} /bin: $PATH

Script de lanzador

Un inconveniente de las descargas manuales de JAR es que no te mantienes al día con la última versión lanzada. Tenemos un script de lanzador bash en bin/utils/openapi-Generator.cli.sh que resuelve este problema.

Para instalar el script de lanzador, copie el contenido del script en una ubicación en su ruta y haga que el script sea ejecutable.

Un ejemplo de configuración de esto (nota: siempre evalúe los scripts acurrucados de los sistemas externos antes de ejecutarlos).

 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/

Ahora, openapi-generator-cli está "instalado". En la invocación, consultará el repositorio de GitHub para la versión lanzada más recientemente. Si esto coincide con el último jar descargado, se ejecutará como normal. Si se encuentra una versión más nueva, el script descargará la última versión y la ejecutará.

Si necesita invocar una versión anterior del generador, puede definir la variable OPENAPI_GENERATOR_VERSION ya sea ad hoc o globalmente. Puede exportar esta variable si desea persistir una versión de lanzamiento específica.

Ejemplos:

 # 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 proyectos

Para construir desde la fuente, necesita lo siguiente instalado y disponible en su $PATH:

Java 11
Apache Maven 3.8.8 o más (opcional)

Después de clonar el proyecto, puede construirlo desde la fuente utilizando Maven Wrapper:

Linux: ./mvnw clean install
Windows: mvnw.cmd clean install

Usuarios de nix

Si eres un usuario de NIX, puedes ingresar a OpenApi Generator Shell, escribiendo:

nix develop

Ingresará un shell con Java 11 instalado.

Direnv admite la carga automática de la shell de desarrollador NIX, por lo que si también está utilizando Direnv, escriba:

direnv allow

Y tenga java y mvn configurados con versiones correctas cada vez que ingrese el directorio de proyectos.

La construcción predeterminada contiene un análisis estático mínimo (a través de checkstyle). Para ejecutar su compilación con PMD y Spotbugs, use el perfil static-analysis :

Linux: ./mvnw -Pstatic-analysis clean install
Windows: mvnw.cmd -Pstatic-analysis clean install

1.5 - Homebrew

Para instalar, ejecute brew install openapi-generator

Aquí hay un uso de ejemplo para generar un 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/

Para reinstalar con el último maestro, ejecute brew uninstall openapi-generator && brew install --HEAD openapi-generator

Para instalar OpenJDK (requisitos previos), ejecute

brew tap AdoptOpenJDK/openjdk
brew install --cask adoptopenjdk11
export JAVA_HOME= ` /usr/libexec/java_home -v 1.11 `

o descargue el instalador a través de https://adoptium.net/

Para instalar Maven (opcional), ejecute

brew install maven

1.6 - Docker

Imágenes de Docker previamente construidas

https://hub.docker.com/r/openapitools/openapi-generator-cli/ (CLI oficial)
https://hub.docker.com/r/openapitools/openapi-generator-online/ (servicio web oficial)

Imagen de Docker del Generador Openapi CLI

La imagen del generador OpenAPI actúa como un ejecutable independiente. Se puede utilizar como una alternativa a la instalación a través de Homebrew, o para desarrolladores que no pueden instalar Java o actualizar la versión instalada.

Para generar código con esta imagen, deberá montar una ubicación local como volumen.

Ejemplo:

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

El código generado se ubicará en ./out/go en el directorio actual.

Imagen de Docker en línea del generador de OpenApi

La imagen OpenApi-Generator-Online puede actuar como una aplicación web y API autohospedada para generar código. Este contenedor se puede incorporar a una tubería CI, y requiere al menos dos solicitudes HTTP y alguna orquestación de Docker para acceder al código generado.

Ejemplo 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

Desarrollo en Docker

Puede usar run-in-docker.sh para hacer todo el desarrollo. Este script asigna su repositorio local a /gen en el contenedor Docker. También se mapea ~/.m2/repository a la ubicación del contenedor apropiado.

Para ejecutar mvn package :

git clone https://github.com/openapitools/openapi-generator
cd openapi-generator
./run-in-docker.sh mvn package

Los artefactos de construcción ahora se pueden acceder en su directorio de trabajo.

Una vez construido, run-in-docker.sh actuará como un ejecutable para OpenApi-Generator-Cli. Para generar código, deberá emitir un directorio en /gen ( /gen/out . Por ejemplo:

./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

Solución de problemas

Si se produce un error como este, simplemente ejecute el comando ./mvnw limpio -u :

org.apache.maven.lifecycle.lifecycleExecutionException: no pudo ejecutar meta org.apache.maven.plugins: maven-surefire-plugin: 2.19.1: prueba (prueba predeterminada) en el proyecto openapi-generator: un tipo de incompatibilidad ocurrió mientras se ejecutaron org.apache.maven.plugins: Maven-Surfire-Plugin: 2.19.1: Prueba: java.lang.ExceptionInitializerError no se puede lanzar a java.io.ioexception

./run-in-docker.sh ./mvnw clean install -U

No se pudo ejecutar la meta org.fortasoft: gradle-maven-plugin: 1.0.8: invoke (predeterminado) en el proyecto Openapi-Generator-Gradle-Plugin-MVN-Wrapper: org.gradle.tooling.buildexception: no se pudo ejecutar la construcción utilizando Distribución 'https://services.gradle.org/distributions/gradle-4.7-bin.zip'

En este momento: no hay solución para este: |

Corre Docker en Vagrant

Prerrequisito: Instale Vagrant y 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

También hay un envoltorio de paquetes NPM disponible para diferentes plataformas (por ejemplo, Linux, Mac, Windows). (Todavía se requiere JVM) Consulte el ReadMe del proyecto allí para obtener más información.

Instálelo a nivel mundial para que la CLI esté disponible en la línea de comando:

npm install @openapitools/openapi-generator-cli -g
openapi-generator-cli version

Para usar una versión específica de "OpenApi-Generator-Cli"

openapi-generator-cli version-manager set 7.10.0

O instálelo como Dev-Dependency:

npm install @openapitools/openapi-generator-cli -D

También puede usar frascos construidos localmente o versiones SNAPSHOT .

2 - Empezando

Para generar un cliente PHP para petstore.yaml, ejecute lo siguiente

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

(Si está en Windows, reemplace el último comando con 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 )

También puede descargar el jar (último lanzamiento) directamente desde maven.org

Para obtener una lista de opciones generales disponibles, ejecute java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar help generate

Para obtener una lista de opciones especificadas PHP (que se pueden pasar al generador con un archivo de configuración a través de la opción -c ), ejecute java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar config-help -g php

3 - Uso

Para generar una biblioteca de cliente de muestra

Puede construir un cliente contra la API de la tienda de mascotas de la siguiente manera:

./bin/generate-samples.sh ./bin/configs/java-okhttp-gson.yaml

(En Windows, instale Git Bash para Windows para ejecutar el comando anterior)

Este script usa la biblioteca predeterminada, que es okhttp-gson . Ejecutará el generador con 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

con varias opciones. Las opciones de Java se documentan aquí.

También puede obtener las opciones con el comando help generate (a continuación solo muestra resultados parciales):

 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

Luego puede compilar y ejecutar el cliente, así como las pruebas unitarias contra él:

 cd samples/client/petstore/java/okhttp-gson
mvn package

Otros generadores también tienen muestras.

3.1 - Personalización

Consulte Customization.md sobre cómo personalizar la salida (por ejemplo, nombre del paquete, versión)

3.2 - Integración de flujo de trabajo (Maven, Gradle, Github, CI/CD)

Consulte Integration.md sobre cómo integrar el generador OpenAPI con Maven, Gradle, SBT, Bazel, GitHub y CI/CD.

3.3 - Generador de Openapi en línea

Aquí están los servicios públicos en línea:

Última versión estable: https://api.openapi-generator.tech
Último maestro: https://api-latest-master.openapi-generator.tech (actualizado con el último maestro cada hora)

El servidor está patrocinado por Linode

(Estos servicios son beta y no tienen ninguna garantía en el nivel de servicio)

Consulte en línea.md sobre cómo ejecutar y usar openapi-generator-online , un servicio web para openapi-generator .

3.4 - Información de licencia sobre el código generado

El proyecto del generador OpenAPI se pretende como un beneficio para los usuarios de la especificación de API Open. El proyecto en sí tiene la licencia como se especifica. Además, comprenda los siguientes puntos:

Las plantillas incluidas con este proyecto están sujetas a la licencia.
El código generado no está sujeto intencionalmente a la licencia de proyecto principal

Cuando el código se genera a partir de este proyecto, se considerará tal como es y es propiedad del usuario del software. No hay garantías, expresadas o implícitas, código generado. Puede hacer lo que desee con él, y una vez generado, el código es su responsabilidad y sujeto a los términos de licencia que considera apropiados.

3.5 - Integración IDE

Aquí hay una lista de complementos IDE tratados con la comunidad que se integran con el generador OpenAPI:

Eclipse: Codewind Openapi Herramientas para Eclipse por IBM
Idea de IntelliJ: Generador Openapi de Jim Schubert
Idea de IntelliJ: editor de Senya por senya.io
Reprezen API Studio
Visual Studio: REST API Generador de código de cliente de Christian Resma Helle
Visual Studio Code: Codewind OpenApi Herramientas por IBM

4 - Empresas/proyectos que utilizan el generador OpenAPI

Aquí hay algunas empresas/proyectos (orden alfabético) utilizando el generador OpenAPI en producción. Para agregar su empresa/proyecto a la lista, visite ReadMe.md y haga clic en el icono para editar la página.

Universidad de Aalborg
ACT Codificación
Soluciones de adaptante AG
adesso se
Adyen
Agoda
Aviso
Aleri Solutions GmbH
Alianza
Angular.schule
Aqovia
Australia y el grupo bancario de Nueva Zelanda (ANZ)
Arduino
Askul
Servicios web de Amazon (AWS)
b <> com
百度营销
Ancho de banda
Nube de Banzai
Bimdata.io
Bithost gmbh
Industria conectada de Bosch
Cajero
Brevy
Grupo de retención de búnker
Universidad Estatal de California, Northridge
LEVA
Campamento
Grupo Carlsberg
Sargento
Christopher Queen Consulting
Cisco
Codecéntrico AG
Coinapi
Comienzo
Configat
Cronn GmbH
Salud cruzada
Cupix
Datadog
Sistel DB
Deeporute.ai
Desarrollador
dmtech gmbh
Puro
dwango
Impulso de borde
Elemento ai
Manifiesto
emino
rápidamente
Fenergo
libre
Cañas frescas
Fusible
Gantner
Flujo de genes
Getyourguide
Glovo
GMO Pepabo
Mierda
Gumtree
Aquí
IBM
Instana
Interxión
Inquisico
Juststar
K6.io
Klarna
Desarrollo de Kronsoft
Kubernetes
Landeshauptstadt München - it@m
Linodo
Lógica
Lumero
LVM Versicherungen
Mailslurp
Búsqueda de manticore
Tarjeta MasterCard
Mezcla
Metaswitch
Visión de la luna
Mykorkout
Namsor
Nunca
Neuereno
Nokia
De otro
Opciones de compensación de la Corporación (OCC)
Openet
Validación abierta
Oráculo
Paxos
Tartán
Plaid, Inc.
Pinterest
Picario
Precio
Printnanny
Prometheus/AlertManager
Qavar
Qedit
Viernes
Sistemas de Qulix
Raksul
Raiffeisen Schweiz Genessenschaft
Redhat
Reprezen API Studio
Descanso unido
Robocorp
Robotinfra
Searchapi
Martillo
Entretenimiento interactivo de Sony
División
Raya
Suva
Svix
Telstra
Tencent
La Universidad de Aizu
Tinqin
APS translúcido
Plataforma de tiempo de viaje
Tribal
Trifor
Tui Infotec GmbH
Twilio
Gorjeo
UNBLU INC.
Con veteja
VMware
soluciones WBT
Woleet
WSO2
Vouchery.io
Xero
Yahoo Japón
vía
Vonage
Tecnología yitu
Gañido
Zalando
3DS fuera de escala

5 - Presentaciones/videos/tutoriales/libros

2018/05/12 - Generador OpenApi - Comunidad impulsada で成長するコードジェネレータ por 中野暁人
2018/05/15 - Comenzar un nuevo proyecto de código abierto de Jeremie Bresson
2018/05/15 - REST API 仕様から API クライアントやスタブサーバを自動生成する「 Openapi Generator 」オープンソースで公開。Swagger Codegen からのフォーク por PublicKey
2018/06/08 - Swagger Codegen ahora es Generador Openapi de Johanneshoppe
2018/06/21 - Conecte sus aplicaciones Jhipster al mundo de las API con Openapi y GRPC de Christophe Bornet en Jhipster Conf 2018
2018/06/22 - Generador OpenApi で Cliente Gatling を生成してみた en ソモサン
2018/06/27 - Lecciones aprendidas al liderar un proyecto de código abierto que admite más de 30 lenguajes de programación - William Cheng en Linuxcon + ContenceCon + Cloudopen China 2018
2018/07/19 - Contribución del generador de OpenAPI QuickStart - RingCentral Go SDK de John Wang
2018/08/22 - Generador de Openapi のプロジェクト構成などのメモ de Yusuke Iinuma
2018/09/12 - Reprezen y Openapi 3.0: Ahora es la hora de Miles Daffin
2018/10/31 - Un envoltorio de paquete de nodo para OpenApi -Generator
2018/11/03 - Openapi Generator + Golang + Flutter でアプリ開発 por Ryuichi Daigo
2018/11/15 - 基于 Openapi3.0 的 Yaml 文件生成 Java 代码的一次实践 por 焱魔王
2018/11/18 - Generación de código de biblioteca PHP de Openapi por Lorna Jane en el blog de Lornajane
2018/11/19 - Openapis está en todas partes por Jeremie Bresson (UNBLU) en Eclipsecon Europe 2018
2018/12/09 - Openapi -Generator をカスタマイズする方法 por @watiko
2019/01/03 - Llamar a un servicio de arrogancia desde Apex utilizando Openapi -Generator de Mikkel Flindt Heisterberg
2019/01/13 - Openapi Generator で RESTFUL API の定義書から色々自動生成する por @KY_YK_D
2019/01/20 - Desarrollo de API de contrato con generador OpenAPI y conexión por Anil Can Aydin
2019/01/30 - Desarrollo rápido de aplicaciones con API Primer enfoque utilizando el generador Open -API por Milan Sonkar
2019/02/02 - 平静を保ち、コードを生成せよ〜〜〜〜〜〜誕生の背景と軌跡誕生の背景と軌跡〜中野暁人中野暁人中野暁人中野暁人中野暁人中野暁人中野暁人中野暁人中野暁人中野暁人中野暁人中野暁人中野暁人中野暁人中野暁人 #34 スキーマ駆動開発
2019/02/20 - Una aventura en la generación de código de Openapi V3 por Phil Cluff
2019/02/26 - Building API Services: una guía para principiantes de Ratros Y. en el blog de Google Cloud Platform Blog
2019/02/26 - API de construcción con Openapi: Continúa por Ratros Y. en el blog de la plataforma de Google Cloud
2019-03-07-Openapi Generator で Spring Boot と Angular をタイプセーフに繋ぐ de Tomofumi Chiba
2019-03-16-Una introducción rápida al manual Openapi V3 de Vados en Vadosware
2019-03-25-Acceda a cualquier servicio de descanso con SAP S/4HANA Cloud SDK por Alexander Duemont
2019-03-25-Generador de Openapi を試してみる por @amuyikam
2019-03-27-OpenApi3 を使ってみよう！ Go 言語でクライアントとスタブの自動生成まで！ por @Gold_Kou
2019-04-17-Openapi によるスキーマファースト開発の実施サンプルと Cloud Run について por @yukey1031
2019-04-18-Cómo usar OpenAPI3 para el desarrollador de API (Rubykaigi 2019) por @OTA42Y en Rubykaigi 2019
2019-04-29-Una guía para principiantes para la generación de códigos para API REST (Generador de Openapi) de William Cheng
2019-05-01-Diseñe y genere una API REST de Swagger / Openapi en Java, Python, C# y más por simplemente cómo
2019-05-17-Genere la API de reposo de arranque de primavera usando Swagger/Openapi de Antonie Zafirov
2019-05-22-REST API 代码生成指南 (Generador de Openapi) de William Cheng, Xin Meng
2019-05-24-REST API 代碼生成指南 (Generador de Openapi) de William Cheng
2019-06-24-Clientes de Kubernetes y Generador de Openapi de William Cheng en Kubernetes contribuyentes Summits Shanghai 2019
2019-06-28 Codewind Openapi Herramientas en Eclipse Marketplace por IBM
2019-06-29 Codewind Openapi Herramientas en Visual Studio Marketplace por IBM
2019-07-04-REST API のためのコード生成入門 (Generador de Openapi) de William Cheng, 中野暁人, 和田拓朗
2019-07-08 - Openapi Generator にコントリビュートしたら社名が載った話。 (CAM) - Blog de Cam Tech de Cam, Inc.
2019-07-14-Openapi Generator で Python のクライアントライブラリを作成した por yuji38kwmt
2019-07-19-Experiencia de desarrollador (DX) para proyectos de código abierto: cómo involucrar a los desarrolladores y construir una creciente comunidad de desarrolladores de William Cheng, 中野暁人 en Open Source Summit Japón 2019 2019
2019-08-14-Nuestro viaje de Openapi con SDK de estandarización de Sebastian Burgstaller en 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 en 腾讯云社区
2019-08-29-全面进化： Kubernetes CRD 1.16 Ga 前瞻 por Min Kim en ServiceMesher Blog
2019-09-01-Creación de un servidor PHP-Slim usando OpenAPI (Video de YouTube) de Daniel Persson
2019-09-06-Vert.x y Openapi por Stephan H Wissel en el blog Wissel.net
2019-09-09-Desarrollo nativo de la nube-Creación de microservicios RESTful en IBM Cloud Docs
2019-09-14: generar y configurar un cliente API de MasterCard en la plataforma MasterCard Developers
2019-09-15-Openapi (Swagger) 導入下調べ de Shoichi Kuraka
2019-09-17-Tutorial: Documentar API HTTP4K con OpenAPI3 por http4k
2019-09-22-Openapi 3 を完全に理解できる本 por @OTA42Y
2019-09-22-API RESTFUL: Tutorial de la especificación de Openapi de Amir Lavasani
2019-09-22-Redefinir los SDK como kits de diversidad de software de Sid Maestre (Xero) en Devrelcon San Francisco 2019
2019-09-23-Swagger から Openapi Generator で Spring のコードを自動生成 de @littlefeet en Qiita
2019-09-24-¡Eine Stunde fue MIT API primero! por @janweinschenker en Java Forum Nord
2019-10-09-Openapi-Generator で生成した Go クライアントで Bearer 認証をする de Akira Tanimura
2019-10-10-Generación automática de clientes REST de Thomas Peyrard, ingeniero de software senior de Criteo en Tech Tech Sports (Meetup)
2019-10-12-Openapi 自动生成 Cliente por 郑泽洲
2019-10-16-¿Cómo enviar API más rápido? por Simon Guilliams @ Ponicode
2019-10-22-Openapi + Spring Boot (Kotlin) でファイルダウンロード API を作成する de Yuki Furukawa
2019-10-24 - Microprofile Openapi - ¿Código primero o diseño primero? por Peter [Pɛʃə] Steiner en Eclipsecon Europe 2019
2019-11-06-Generación de clientes API basados en las especificaciones de OpenAPI V3 por Dominik Jastrzębski @ 98Elements
2019-11-06-Openapi を利用して自前の API サーバー (Sinatra) を移植した時のメモ por Yasuhiro Abe
2019-11-07 - API First Development con OpenApi - ¡Deberías practicarlo! Por Nick Van Hoof en Devoxx Bélgica 2019
2019-11-08-Jhipster Beyond Crud-API-First for Enterprises by Enrico Costanzi por Enrico Costanzi en Jhipster Conf 2019 en París
2019-11-11-TypeScript REST API クライアント por @unhurried
2019-11-11: una especificación para gobernarlos a todos - Openapi en acción de Andreas Litt en Code.Talks 2019
2019-11-13-Editor y generador de OpenApi 3.0 con un ejemplo de arranque de primavera en simplemente cómo
2019-11-17-Lista de reproducción de YouTube del generador de Openapi en YouTube
2019-11-20-Introducción a Openapi por Lorna Mitchell en Goto Copenhagen 2019
2019-11-20-Cómo generar código angular a partir de las especificaciones de OpenApi por Anuraj
2019-11-23-Swagger ではない Openapi Especificación 3.0 による API サーバー開発 por tetsuya Morimoto en JJUG CCC 2019 Fall
2019-11-24-Acelerar el desarrollo de Flutter con Openapi y Dart Code Generation por Irina Southwell
2019-11-25-Openapi-Generator で手軽にスタブサーバとクライアントの生成 por @PhoPocho13
2019-11-26-Cordacon 2019 Highlights: Braid Server y OpenApi Generator para las API de Corda Client de Adel Rustum en B9Lab
2019-12-03-A Road to Less Coding: Auto Generado Apilibrary en el blog de Corda
2019-12-04-Angular ＋ Nestjs ＋ Openapi （Swagger ）でマイクロサービスを視野に入れた環境を考える por てらしー
2019-12-05-Generación de código en la VM Java de Sean Sullivan
2019-12-17-Generador OpenAPI で OAuth2 アクセストークン発行のコードまで生成してみる por TechScore
2019-12-23-Use ADA para su desarrollo web por Stephane Carrez
2019-12-23-Openapi のスキーマを分割・構造化していく方法 por 小飯塚達也小飯塚達也小飯塚達也小飯塚達也小飯塚達也小飯塚達也小飯塚達也小飯塚達也小飯塚達也小飯塚達也小飯塚達也小飯塚達也小飯塚達也小飯塚達也小飯塚達也小飯塚達也小飯塚達也
2020-01-17-Demo de Openapi para Pulp 3.0 Ga por pulpa en YouTube
2020-01-19-¿Por qué documentar una API REST como código? por Rolf Streefkerk en la comunidad de Dev
2020-01-28-recupere su arrogancia sin servidor con Openapi de Matt Tyler
2020-01-30-Generador de Openapi へのコントリビュート por yutaka0m
2020-02-01-Uso de OpenAPI para maximizar su experiencia Pulp 3 por Dennis Kliban en Fosdem
2020-02-07-Por qué debe usar OpenAPI para su diseño de API de Nick Van Hoof en API Conference
2020-02-17-Rubynetes: Uso de OpenApi para validar las configuraciones de Kubernetes de Neil Wilson en BrightBox
2020-02-20-Construyendo SDK para el futuro por Sid Maestre (Xero)
2020-02-27-NUXT 利用プロダクトで IE11 と仲良くするための E2E en Medpeer.co.jp Blog de tecnología
2020-02-29-Brindar apoyo a los dispositivos IoT desplegados en el entorno rural desconectado (documento de conferencia) por Sergio Laso, Daniel Flores-Martín, Juan Luis Herreracarlos, Canaljuan Manuel, Murillovier Berrocal
2020-03-02-Cómo generar el código Angular y Spring a partir de la especificación de Openapi por Michael Hoffmann
2020-03-02-Openapi Generator + TypeScript で始める自動生成の型に守られた豊かなクライアント生活 por 五百蔵直樹直樹直樹直樹株式会社株式会社
2020-03-10-Reunión del generador de Openapi #1 por 中野暁人 en Openapi Generator Meetup #1
2020-03-15-Carga de prueba de su API con Swagger/Openapi y K6
2020-04-13-俺的【俺的【俺的【】との向き合い方】との向き合い方 (爆速で爆速で爆速でと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろうと友達になろう uct.
2020-04-22-Introducción al generador de Openapi por Kristopher Sandoval en API nórdicas
2020-04-27-Cómo utilizamos la especificación Open API V3 para generar documentación de API de generación automática, snippets y clientes de Tanel Tähepõld
2020-05-09-Openapi でお手軽にモック API サーバーを動かす de Sachie Kamba
2020-05-18-Boot de primavera con Openapi 3 de Alfonz Jan Frithz
2020-05-19-API SIMPLES DE MUERTO con API abierta de Chris Tankersley en Nexmo
2020-05-22-Cliente de API REST de TypeScript por "Unrached"
2020-05-28 - 【使用 Lotify + Swagger 建置可共用的 Línea Notificar bot】 - #nijia @ Chatbot desarrollador Taiwán 第 #19 小聚 por el desarrollador de chatbot Taiwán
2020-05-28-API de construcción con Laravel usando Openapi de Chris Tankersley en Laracon EU
2020-06-12-Interoperabilidad por construcción: Generación de códigos para clientes de Arrowhead de Michele Albano, Brian Nielsen en 2020 Conferencia IEEE sobre sistemas cibernéticos industriales (ICPS)
2020-06-23-新規サーバーアプリケーションに TypeScript を採用してみた en Cam Tech Blog
2020-06-29-Artifact Resumen: despliegue de API en dispositivos móviles de Android y microcontroladores por Sergio Laso; Marino Linaje; José García-Alonso; Juan M. Murillo; Javier Berrocal en 2020 Conferencia Internacional IEEE sobre Computación y Comunicaciones Permanentes (PERCOM)
2020-07-07-5 mejores herramientas de documentación de API de Susanna Bouse en DreamFactory Blog
2020-07-12-Open API 3.0 の定義から Golang のサーバコードのスケルトンを作成する de @Professor (blog Qiita)
2020-07-20-Bibliotecas de clientes de la API de Datadog ahora disponibles para Java y ir por Jordan Obey en el blog de Datadog
2020-07-23-Genere SDK del cliente para .NET Core utilizando API Open de Nuno Reis
2020-07-26-Dart の http_interceptor ライブラリを使うと配列のクエリパラメータが消えてしまう件の応急処置 por @Gyamoto
2020-08-01-Genere formas reactivas angulares de Swagger/Openapi por Martin McWhorter
2020-08-03-Criang Bibliotecas para apis Restful Com Openapi, Swagger Editor E Openapi Generator de Everis Brasil (una compañía de datos NTT)
2020-08-19-マイクロサービスを連携してみよう por 岡井裕矢裕矢 (おかいゆうや), 泉勝 (いずみまさるまさるまさるまさるまさるまさる).
2020-08-25-Generador OpenApi と TypeScript で型安全にフロントエンド開発をしている話 en Smarthr Tech Blog
2020-09-10-Introducción a Openapi con Instana por Cedric Ziel en el blog Instana
2020-09-17-Genere PowerShellsdk usando Openapi-Generator por Ghufran Zahidi
2020-09-24 - Cómo automatizar la generación de código API (OpenApi/Swagger) y impulsar la productividad - Tutorial con React Native con TypeScript de Sanjin Celeski
2020-09-25-Genere el cliente angular de Openapi por Patric
2020-10-24 - Trabajando con Microsoft Identity - React Native Client por Joseph Guadagno
2020-10-31-[B2] Especificación de Openapi 으로 타입-세이프하게 API 개발하기: 희망편 vs 절망편 por 최태건 en FECONF 2020
2020-11-05-Generación de código Automated REST-API: Wie It-Systeme Miteinander Sprechen por Stefan Rottensteiner en Massive Art Blog
2020-12-01-Generador de Openapi で Go の API サーバー/クライアントコードを自動生成する por @saki-ingeniería
2020-12-04-Escala de la cobertura de prueba del generador OpenAPI para más de 30 lenguajes de programación por William Cheng en Open Source Summit Japón + Automotive Linux Summit 2020 (diapositivas)
2020-12-09-プロジェクトに Openapi Generator で自動生成された型付き Cliente API を導入した話 por @Yoshifujit
2020-12-15-Next.js + Nestjs + GraphQL で変化に追従するフロントエンドへ〜ショッピングクーポンの事例紹介ショッピングクーポンの事例紹介小倉陸陸陸陸陸陸陸陸陸陸陸陸陸陸陸陸Blog de Japan Tech
2021-01-08-Hola, nueva API-Parte 1 de Jeremy Schulman en Major League Baseball
2021-01-18-「アプリ開発あるある」を疑うことから始まった、 Cliente de API コードの自動生成【デブスト 2020】 por Codezine 編集部
2021-02-05-REST-API-Roundtrip con SpringDoc y OpenApi Generator de Benjamin Klatt en Viadee
2021-02-17-REST-API-RoundTrip con SpringDoc y OpenApi Generator de Cloud @Viadee
2021-03-08-Generador OpenApi 工具的躺坑尝试 por 独家雨天 en CSDN 官方博客
2021-03-16-如何基于 Swagger 使用 Openapi Generator 生成 JMeter 脚本？ por 高楼 Zee en 腾讯云专栏
2021-03-24-Openapi-Generator-Cli による TypeScript 型定義 por TakeFumi Yoshii
2021-03-28-Probar Nestjs Parte 4: Generar clientes mecanografiados a partir de documentos de OpenApi por Arnaud Cortisse
2021-03-31-Implementación del servidor API de OPER utilizando el generador OpenApi en Baeldung
2021-03-31-使用 Openapi Generator 實現 Open API Server en 億聚網
2021-04-19-Presentación de las especificaciones beta de Openapi de Twilio por Gareth Paul Jones en el blog de Twilio
2021-04-22-Aprovechando las fortalezas de OpenAPI en un entorno de micro-servicio de Nicolas Jellab en Unibuddy Technology Blog
2021-04-27-De cero a la publicación de clientes de la API de PowerShell en PowerShell Gallery en minutos por William Cheng en PowerShell + DevOps Global Summit 2021
2021-05-31-Flutter で Generador de API abierto (arrogancia) を使う por Aakira
2021-06-22-Documentación de API REST y generación de clientes con 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
Documentación
- AsciiDoc: @man-at-home
- HTML Doc 2: @jhitchcock
- Confluence Wiki: @jhitchcock
- PlantUML: @pburls
Configuración
- 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)
Androide	@jaz-ah (2017/09)
Ápex
Intento	@frol (2017/07) @bkryza (2017/08) @kenjones-cisco (2017/09)
do	@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)
DO#	@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)
Gráfico	@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)
Kotlín	@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)
Pitón	@cbornet (2017/09) @tomplus (2018/10) @krjakbrjak (2023/02) @fa0311 (2023/10) @multani (2023/10)
Riñonal	@Ramanth (2019/07) @saigiridhar21 (2019/07)
Rubí	@cliffano (2017/07) @zlx (2017/09) @autopp (2019/02)
Óxido	@frol (2017/07) @farcaller (2017/08) @richardwhiuk (2019/07) @paladinzh (2020/05) @jacob-pro (2022/10)
Escala	@clasnake (2017/07), @shijinkui (2018/01), @ramzimaalej (2018/03), @chameleon82 (2020/03), @Bouillie (2020/04) @fish86 (2023/06)
Rápido	@jgavris (2017/07) @ehyche (2017/08) @Edubits (2017/09) @jaz-ah (2017/09) @4brunu (2019/11) @dydus0x14 (2023/06)
Mecanografiado	@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)
Pitón	@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 Generador". 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

Licenciado bajo la licencia Apache, versión 2.0 (la "licencia"); No puede usar este archivo, excepto de conformidad con la licencia. You may obtain a copy of the License at apache.org/licenses/LICENSE-2.0

A menos que la ley aplicable sea requerida o acordado por escrito, el software distribuido bajo la licencia se distribuye de manera "como es", sin garantías o condiciones de ningún tipo, ya sea expresas o implícitas. Consulte la licencia para los permisos y limitaciones de rigor de idioma específico bajo la licencia.

Expandir