Téléchargement openapi generator - Téléchargement du code source openapi generator

Générateur OpenAPI

Master ( 7.11.0 ):

Si vous souhaitez contribuer, veuillez vous référer aux directives et à une liste de tâches ouvertes.

‼ ️ Pour migrer de Swagger Codegen au générateur OpenAPI, veuillez vous référer au guide de migration ‼ ️

? Pour plus d'informations, veuillez vous référer à la page Wiki et à la FAQ?

? L'ebook A débutant Guide to Code Generation for REST API est un bon point de départ pour les débutants?

️ Si les spécifications OpenAPI, les modèles ou toute entrée (par exemple, les options, les variables d'environnement) sont obtenues à partir d'une source ou d'un environnement non fiable, assurez-vous d'avoir examiné ces entrées avant d'utiliser le générateur OpenAPI pour générer le client de l'API, le talon de serveur ou la documentation pour éviter d'éviter d'éviter Problèmes de sécurité potentiels (par exemple, injection de code). Pour les vulnérabilités de sécurité, veuillez contacter [email protected]. ️

‼ ️ Les deux "OpenAPI Tools" (https://openapitools.org - l'organisation parentale du générateur OpenAPI) et "Générateur OpenAPI" ne sont pas affiliées à l'OpenAPI Initiative (OAI) ‼ ️

Aperçu

Le générateur OpenAPI permet à la génération de bibliothèques clients API (génération SDK), aux talons du serveur, à la documentation et à la configuration étant automatiquement donné une spécification OpenAPI (les deux et 3.0 sont pris en charge). Actuellement, les langues / cadres suivants sont pris en charge:

	Langues / frameworks
Clients API	ActionScript , Ada , Apex , Bash , C , C # (.NET 2.0, 3.5 ou version ultérieure, .NET Standard 1.3 - 2.1, .NET Core 3.1, .NET 5.0. Libraries: Restharp, 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, rétrofit1.x, rétrofit2.x, feign, restTEmplate, reseasy, vertx, google API bibliothèque client pour java, assuré de repos, client Web printemp ), JetBrains Http Client , Julia , K6 , Kotlin , Lua , N4JS , NIM , Node.js / javascrip , 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), dactylographié (angularjs, angulaire (9.x - 18.x), aurelia, axios, fetch, inversify, jQuery, nestjs, nœud, redux-query, rxjs), Xojo , Zapier
Talons de serveur	ADA , C # (ASP.NET Core, Azure Functions), C ++ (Pistache, Restated, QT5 QHTTPENGINE), ERLANG , F # (Giraffe), Go (Net / Http, Gin, Echo), Haskell (Servant, Yesod), Java ( MSF4J, Spring, Undertow, Jax-RS: CDI, CXF, Inflector, Jersey, Reseasy, 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)
Générateurs de documentation API	HTML , Wiki Confluence , Asciidoc , Markdown , Plantuml
Fichiers de configuration	Apache2
Autres	GraphQL , JMeter , Ktorm , Schéma MySQL , collection Postman , tampon de protocole , WSDL

Table des matières

Générateur OpenAPI
Aperçu
Table des matières
1 - installation
- 1.1 - Compatibilité
- 1.2 - Artefacts sur Maven Central
- 1.3 - Télécharger le pot
- 1.4 - Construire des projets
- 1.5 - Homebrew
- 1.6 - Docker
- 1.7 - NPM
2 - Début
3 - utilisation
- 3.1 - Personnalisation
- 3.2 - Intégration du flux de travail
- 3.3 - Générateurs en ligne
- 3.4 - Informations sur la licence sur le code généré
- 3.5 - INDÉGRATION IDE
4 - Entreprises / Projets utilisant un générateur OpenAPI
5 - Présentations / vidéos / tutoriels / livres
6 - À propos de nous
- 6.1 - Équipe de base du générateur OpenAPI
- 6.2 - Comité technique du générateur OpenAPI
- 6.3 - Historique du générateur OpenAPI
7 - Licence

1 - installation

1.1 - Compatibilité

La spécification OpenAPI a subi 3 révisions depuis la création initiale en 2010. Le projet OpenAPI-Generator a les compatibilités suivantes avec la spécification OpenAPI:

Version du générateur OpenAPI	Date de sortie	Notes
7.11.0 (version mineure à venir)	20.12.2024	Libération mineure avec des changements de rupture (avec le secours)
7.10.0 (dernière version stable)	18.11.2024	Libération mineure avec des changements de rupture (avec le secours)
6.6.0	11.05.2023	Libération mineure avec des changements de rupture (avec le secours)
5.4.0	31.01.2022	Libération mineure avec des changements de rupture (avec le secours)
4.3.1	06.05.2020	Version du patch (améliorations, corrections de bogues, etc.)

Compatibilité des spécifications OpenAPI: 1.0, 1.1, 1.2, 2.0, 3.0, 3.1 (support bêta)

(Nous ne publions pas de construction quotidienne / nocturne. Veuillez utiliser à la place)

Pour les anciennes versions, veuillez vous référer à la page de version .

Pour les générateurs / bibliothèques / frameworks décomistés, veuillez vous référer à l'étiquette "Decommission" dans la page Pull Request.

1.2 - Artefacts sur Maven Central

Vous pouvez trouver nos artefacts publiés sur Maven Central:

Cœur:

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

Voir les différentes versions de l'artefact OpenAPI-Generator disponible sur Maven Central.

CLI:

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

Voir les différentes versions de l'artefact OpenAPI-Generator-Cli disponible sur Maven Central.

Plugin Maven:

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

Voir les différentes versions de l'artefact OpenAPiAPi-Generator-Maven-Plugin disponible sur Maven Central.
Réadmettre

Plugin Gradle:

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

Voir les différentes versions de l'artefact OpenAPIAPi-Generator-Gradle-Plugin disponible sur Maven Central.
Réadmettre

1.3 - Télécharger le pot

Si vous recherchez la dernière version stable, vous pouvez le saisir directement à partir de maven.org (Java 11 Runtime au minimum):

Emplacement de Jar: https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/7.10.0/openapi-generator-cli-7.10.0.jar

Pour les utilisateurs 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

Pour les utilisateurs de Windows , vous devrez installer WGET ou vous pouvez utiliser invoke-webrequest dans PowerShell (3.0+), par exemple

 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

Après avoir téléchargé le pot, exécutez java -jar openapi-generator-cli.jar help à montrer l'utilisation.

Pour les utilisateurs de Mac, veuillez vous assurer que Java 11 est installé (Conseils: exécutez java -version pour vérifier la version) et exporter JAVA_HOME afin d'utiliser la version Java prise en charge:

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

Script de lanceur

Un inconvénient des téléchargements manuels en pot est que vous ne vous tenez pas à jour avec la dernière version publiée. Nous avons un script de lanceur de bash chez bin / utils / openapi-generator.cli.sh qui résout ce problème.

Pour installer le script de lanceur, copiez le contenu du script sur un emplacement sur votre chemin et rendez le script exécutable.

Un exemple de la configuration (Remarque: Évaluez toujours les scripts bouclés à partir de systèmes externes avant de les exécuter).

 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/

Maintenant, openapi-generator-cli est "installé". Sur Invocation, il interrogera le référentiel GitHub pour la dernière version publiée. Si cela correspond au dernier pot téléchargé, il s'exécutera normalement. Si une version plus récente est trouvée, le script téléchargera la dernière version et l'exécutera.

Si vous devez invoquer une ancienne version du générateur, vous pouvez définir la variable OPENAPI_GENERATOR_VERSION soit ad hoc ou mondialement. Vous pouvez exporter cette variable si vous souhaitez persister une version de version spécifique.

Exemples:

 # 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 - Construire des projets

Pour construire à partir de Source, vous avez besoin des installations et disponibles suivantes dans votre $PATH:

Java 11
Apache Maven 3,8.8 ou plus (facultatif)

Après cloner le projet, vous pouvez le construire à partir de la source à l'aide de Maven Wrapper:

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

Utilisateurs NIX

Si vous êtes un utilisateur NIX, vous pouvez entrer le shell de générateur OpenAPI, en tapant:

nix develop

Il entrera un shell avec Java 11 installé.

Direnv prend en charge le chargement automatique du shell de développeur NIX, donc si vous utilisez aussi Direnv, tapez:

direnv allow

Et demandez java et mvn de configurer avec des versions correctes chaque fois que vous entrez dans le répertoire du projet.

La version par défaut contient une analyse statique minimale (via CheckStyle). Pour exécuter votre construction avec PMD et Spotbugs, utilisez le profil static-analysis :

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

1.5 - Homebrew

Pour installer, exécutez brew install openapi-generator

Voici un exemple d'utilisation pour générer un client 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/

Pour réinstaller avec le dernier maître, exécutez brew uninstall openapi-generator && brew install --HEAD openapi-generator

Pour installer OpenJDK (pré-requis), veuillez exécuter

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

ou téléchargez l'installateur via https://adoptium.net/

Pour installer maven (facultatif), veuillez exécuter

brew install maven

1.6 - Docker

Images de docker pré-construites publiques

https://hub.docker.com/r/openapitools/openapi-generator-cli/ (CLI officiel)
https://hub.docker.com/r/openapitools/openapi-generator-online/ (service Web officiel)

Image de Docker CLI du générateur OpenAPI

L'image du générateur OpenAPI agit comme un exécutable autonome. Il peut être utilisé comme alternative à l'installation via Homebrew, ou pour les développeurs qui ne sont pas en mesure d'installer Java ou de mettre à niveau la version installée.

Pour générer du code avec cette image, vous devrez monter un emplacement local en tant que volume.

Exemple:

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

Le code généré sera situé sous ./out/go dans le répertoire actuel.

Image docker en ligne du générateur OpenAPI

L'image OpenAPI-Generator-Online peut agir comme une application Web et une API auto-hébergées pour la génération de code. Ce conteneur peut être incorporé dans un pipeline CI et nécessite au moins deux demandes HTTP et une orchestration Docker pour accéder au code généré.

Exemple d'utilisation:

 # 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

Développement dans Docker

Vous pouvez utiliser run-in-docker.sh pour faire tout le développement. Ce script mappe votre référentiel local vers /gen dans le conteneur Docker. Il mappe également ~/.m2/repository à l'emplacement du conteneur approprié.

Pour exécuter mvn package :

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

Les artefacts de construction sont désormais accessibles dans votre répertoire de travail.

Une fois construit, run-in-docker.sh agira comme un exécutable pour OpenAPi-Generator-CLI. Pour générer du code, vous devrez sortir vers un répertoire sous /gen (par exemple /gen/out ). Par exemple:

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

Dépannage

Si une erreur comme celle-ci se produit, exécutez simplement la commande ./Mvnw Clean Installer -u :

org.apache.maven.lifecycle.lifecycleExecutionException: n'a pas réussi à exécuter le but org.apache.maven.plugins: maven-surefire-plagin: 2.19.1: test (test par défaut) sur le projet openapi-generator: une incompatibilité de type s'est produite lors de l'exécution du projet OpenAPI-Generator: un type d'incompatibilité s'est produit lors de l'exécution du projet OpenAPI-Generator: Une incompatibilité type s'est produite pendant l'exécution lors de l'exécution org.apache.maven.plugins: Maven-Surefire-Plugin: 2.19.1: Test: java.lang.ExceptioninInitializerror ne peut pas être jeté à java.io.ioexception

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

Échec de l'exécution de but org.fortasoft: gradle-maven-plagin: 1.0.8: invoquer (par défaut) sur le projet openapi-generator-gradle-plagin-mvn-wrapper: org.gradle.tooling.buildException: n'a pas pu exécuter la construction à l'aide de gradle Distribution 'https://services.gradle.org/distribution/gradle-4.7-bin.zip'

En ce moment: aucune solution pour celle-ci: |

Exécutez Docker dans Vagrant

Préalable: installer Vagrant et 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

Il existe également un emballage de package NPM disponible pour différentes plates-formes (par exemple Linux, Mac, Windows). (JVM est toujours requis) Veuillez consulter la lecture du projet pour plus d'informations.

Installez-le à l'échelle mondiale pour obtenir la CLI disponible sur la ligne de commande:

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

Pour utiliser une version spécifique de "OpenAPI-Generator-Cli"

openapi-generator-cli version-manager set 7.10.0

Ou l'installez-le en fonction de la dépendance:

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

Vous pouvez également utiliser des pots ou des versions SNAPSHOT construits localement.

2 - Début

Pour générer un client PHP pour petstore.yaml, veuillez exécuter ce qui suit

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 vous êtes sous Windows, remplacez la dernière commande par 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 )

Vous pouvez également télécharger le pot (dernière version) directement sur maven.org

Pour obtenir une liste des options générales disponibles, veuillez exécuter java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar help generate

Pour obtenir une liste d'options PHP spécifiées (qui peuvent être transmises au générateur avec un fichier de configuration via l'option -c ), veuillez exécuter java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar config-help -g php

3 - utilisation

Pour générer un exemple de bibliothèque client

Vous pouvez construire un client contre l'API Petstore comme suit:

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

(Sur Windows, veuillez installer Git Bash pour Windows pour exécuter la commande ci-dessus)

Ce script utilise la bibliothèque par défaut, qui est okhttp-gson . Il exécutera le générateur avec cette commande:

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

avec un certain nombre d'options. Les options Java sont documentées ici.

Vous pouvez également obtenir les options avec la commande help generate (ci-dessous affiche uniquement les résultats partiels):

 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

Vous pouvez ensuite compiler et exécuter le client, ainsi que des tests unitaires contre lui:

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

D'autres générateurs ont également des échantillons.

3.1 - Personnalisation

Veuillez vous référer à Customation.md sur la façon de personnaliser la sortie (par exemple, nom du package, version)

3.2 - Intégration du flux de travail (Maven, Gradle, Github, CI / CD)

Veuillez vous référer à Integration.md sur la façon d'intégrer le générateur OpenAPI avec Maven, Gradle, SBT, Bazel, Github et CI / CD.

3.3 - Générateur OpenAPI en ligne

Voici les services publics en ligne:

Dernière version stable: https://api.openapi-generator.tech
Dernier Master: https://api-latest-master.openapi-generator.tech (mis à jour avec le dernier maître chaque heure)

Le serveur est parrainé par Linode

(Ces services sont bêta et n'ont aucune garantie au niveau du service)

Veuillez vous référer à Online.md sur la façon d'exécuter et d'utiliser l' openapi-generator-online - un service Web pour openapi-generator .

3.4 - Informations sur la licence sur le code généré

Le projet OpenAPI Generator est destiné à un avantage pour les utilisateurs de la spécification API Open. Le projet lui-même a la licence comme spécifié. De plus, veuillez comprendre les points suivants:

Les modèles inclus avec ce projet sont soumis à la licence.
Le code généré n'est intentionnellement pas soumis à la licence du projet parent

Lorsque le code est généré à partir de ce projet, il doit être pris en compte tel quel et détenu par l'utilisateur du logiciel. Il n'y a pas de garantie - exprimée ou implicite - du code généré. Vous pouvez faire ce que vous le souhaitez, et une fois généré, le code est votre responsabilité et soumis aux termes de licence que vous jugez appropriés.

3.5 - INDÉGRATION IDE

Voici une liste de plug-ins IDE transférés par la communauté qui s'intègrent au générateur OpenAPI:

Eclipse: Codewind OpenAPI Tools for Eclipse by IBM
Intellij Idea: Générateur OpenAPI par Jim Schubert
Intellij Idea: Senya rédacteur en chef par Senya.io
Studio API Reprezen
Visual Studio: Générateur de code client API REST par Christian Resma Helle
Code Visual Studio: Codewind OpenAPI Tools by IBM

4 - Entreprises / Projets utilisant un générateur OpenAPI

Voici quelques entreprises / projets (ordre alphabétique) utilisant le générateur OpenAPI en production. Pour ajouter votre entreprise / projet à la liste, veuillez visiter readme.md et cliquez sur l'icône pour modifier la page.

Université Aalborg
codage d'actes
Adaptant Solutions Ag
adesso se
Addyen
Agoda
Airthings
Aleri Solutions GmbH
Alrianz
Angular.schule
Aqovia
Australie et New Zealand Banking Group (ANZ)
Arduino
Astuce
Amazon Web Services (AWS)
b <> com
百度营销
Bande passante
Nuage de banzai
Bimdata.io
Bithost gmbh
Industrie connectée à Bosch
En boîte
Brevy
Groupe de tenue de bunker
California State University, Northridge
CAME
Camptocamp
Groupe Carlsberg
Cern
Christopher Queen Consulting
Cisco
CodeCentric Ag
Coinapi
Commercicis
Configcat
Cronn GmbH
Santé croisée
Cupix
Médecin de données
DB Systel
DeeporUte.ai
Dévouement
dmtech gmbh
Docspring
dwango
Impulsion de bord
Élément AI
Embotes
émineo
rapidement
Fenergo
libre
Vitesses fraîches
Fusible
Gantner
Genflow
Getyourguide
Glovo
OGM Pepabo
Godaddy
Gumtree
Ici
Ibm
Instana
Interxion
Inquisico
Juststar
k6.io
Klarna
Développement de Kronsoft
Kubernetes
Landeshauptstadt München - it @ m
Linode
Logique
Lumeris
LVM Versicherungen
Mailslurp
Recherche de Manticore
MasterCard
Médiavision
Métaswitch
Vision de la lune
Mon ouvrier
Namsor
Ne jamais faire
Neuenergy
Nokia
Onesignal
Options Clearing Corporation (OCC)
Ouverture
cotisation ouverte
Oracle
Paxos
Plaid
Plaid, Inc.
Pinterest
Ponicode
PriceFx
Printnanny
Prométhée / Alertmanager
Qavar
Qédit
Quadrillage
Systèmes Qulix
Raksul
Raiffeisen schweiz gendenschaft
Redhat
Studio API Reprezen
Rest United
Robocorp
Robotinfra
Searchapi
Smarthrh
Sony Interactive Entertainment
Division
Gâchage
Suva
Svix
Telstra
Tencent
L'Université d'Aizu
Tinqin
APS translucides
Plate-forme de déplacement
Échec des tribus
Trifork
Tui infotec gmbh
Twilio
Gazouillement
unblu inc.
Se réamorcer
Vmware
Solutions WBT
Woleet
Wso2
Priony.io
Xero
Yahoo Japan
videe
Vonage
Technologie Yitu
Japper
Zalando
3DS OUTSCALE

5 - Présentations / vidéos / tutoriels / livres

2018/05/12 - Générateur OpenAPI - conduite par la communauté で成長するコードジェネレータ par 中野暁人
2018/05/15 - Démarrage d'un nouveau projet open-source par Jeremie Bressson
2018/05/15 - API REST 仕様から API クライアントやスタブサーバを自動生成する「 Générateur OpenAPI 」オープンソースで公開。Swagger Codegen からのフォーク par publickey
2018/06/08 - Swagger Codegen est maintenant un générateur OpenAPI par Johanneshoppe
2018/06/21 - Connectez vos applications Jhipster au monde des API avec OpenAPI et GRPC par Christophe Bornet à Jhipster Conf 2018
2018/06/22 - Générateur OpenAPI で Gatling Client を生成してみた at ソモサン
2018/06/27 - Leçons apprises de la direction d'un projet open-source soutenant plus de 30 langages de programmation - William Cheng à Linuxcon + Confenercon + CloudOpen China 2018
2018/07/19 - Contribution du générateur OpenAPI Quickstart - RingCentral Go Sdk par John Wang
2018/08/22 - Générateur OpenAPI のプロジェクト構成などのメモ par Yusuke Iinuma
2018/09/12 - Reprezen et OpenAPI 3.0: c'est maintenant le moment de Miles Daffin
2018/10/31 - Un emballage de package de nœuds pour OpenAPi-Generator
2018/11/03 - Générateur OpenAPI + Golang + Flutter でアプリ開発 par Ryuichi Daigo
2018/11/15 - 基于 OpenAPI3.0 的 Yaml 文件生成 Java 代码的一次实践 par 焱魔王
2018/11/18 - Génération du code de bibliothèque PHP à partir d'OpenAPI par Lorna Jane sur le blog de Lornajane
2018/11/19 - Les OpenAPis sont partout par Jeremie Bressson (unblu) à Eclipsecon Europe 2018
2018/12/09 - OpenAPI-Generator をカスタマイズする方法 by @watiko
2019/01/03 - Appeler un service de fanfaronnade d'Apex à l'aide d'OpenAPi-Generator par Mikkel Flindt Heisterberg
2019/01/13 - Générateur OpenAPI で API RESTFul の定義書から色々自動生成する par @ky_yk_d
2019/01/20 - Développement contractuel de l'API avec un générateur OpenAPI et Connexion par Anil Can Aydin
2019/01/30 - Développement rapide des applications avec première approche API Utilisation du générateur Open-API par Milan Sonkar
2019/02/02 - 平静を保ち、コードを生成せよ〜 Générateur OpenAPI 誕生の背景と軌跡〜 par 中野暁人 à Gunma.web # 34 スキーマ駆動開発
2019/02/20 - Une aventure à OpenAPI V3 Génération de code par Phil Cluff
2019/02/26 - Services d'API de construction: un guide pour débutant de Ratros Y. dans Google Cloud Platform Blog
2019/02/26 - Construire des API avec OpenAPI: Suite par Ratros Y. dans Google Cloud Platform Blog
2019-03-07 - Générateur OpenAPI で Spring Boot と Angular をタイプセーフに繋ぐ par Tomofumi Chiba
2019-03-16 - Une introduction rapide au manuel OpenAPI V3 par Vados à Vadosware
2019-03-25 - Accédez à n'importe quel service de repos avec le SAP S / 4HANA Cloud SDK par Alexander Duemont
2019-03-25 - Générateur OpenAPI を試してみる par @amuyikam
2019-03-27 - OpenAPI3 を使ってみよう！ Go 言語でクライアントとスタブの自動生成まで！ par @gold_kou
2019-04-17 - OpenAPI によるスキーマファースト開発の実施サンプルと Cloud Run について by @ yukey1031
2019-04-18 - Comment utiliser OpenAPI3 pour le développeur API (Rubykaigi 2019) par @ ota42y à Rubykaigi 2019
2019-04-29 - A Guide du débutant pour la génération de code pour les API REST (générateur OpenAPI) par William Cheng
2019-05-01 - Concevez et générez une API REST à partir de Swagger / OpenAPI à Java, Python, C # et plus par simplement comment
2019-05-17 - Générez une API Spring Boot REST en utilisant Swagger / OpenAPI par Antonie Zafirov
2019-05-22 - API REST 代码生成指南 (Générateur OpenAPI) par William Cheng, Xin Meng
2019-05-24 - API REST 代碼生成指南 (Générateur OpenAPI) par William Cheng
2019-06-24 - Clients Kubernetes et générateur OpenAPI par William Cheng à Kubernetes Contributeur Summits Shanghai 2019
2019-06-28 Codewind OpenAPI Outils dans Eclipse Marketplace par IBM
2019-06-29 Codewind OpenAPI Outils dans Visual Studio Marketplace par IBM
2019-07-04 - API REST のためのコード生成入門 (Générateur OpenAPI) par William Cheng, 中野暁人, 和田拓朗
2019-07-08 - OpenAPI Generator にコントリビュートしたら社名が載った話。 (CAM) - CAM Tech Blog par Cam, Inc.
2019-07-14 - Générateur OpenAPI で Python のクライアントライブラリを作成した par yuji38kwmt
2019-07-19 - Expérience des développeurs (DX) pour les projets open source: comment engager les développeurs et construire une communauté de développeurs en pleine croissance par William Cheng, 中野暁人 à l'open source Summit Japan 2019
2019-08-14 - Notre voyage OpenAPI avec standardizon les SDK par Sebastian Burgstaller à Bitmovin
2019-08-15 - API のコードを自動生成させたいだけなら GRPC でなくてもよくない? par M3, Inc.
2019-08-22 - マイクロサービスにおける API Web スキーマの管理 ─ GraphQL 、 Grpc 、 OpenAPI の特徴と使いどころ par @ ota42y
2019-08-24 - Swagger ドキュメントから Générateur OpenAPI を使ってモックサーバー作成 par 坂本正義
2019-08-29 - OpenAPI 初探 par Peakxie à 腾讯云社区
2019-08-29 - 全面进化： Kubernetes CRD 1.16 GA 前瞻 par Min Kim sur Servicemesher Blog
2019-09-01 - Création d'un serveur PHP-SLIM à l'aide d'OpenAPI (vidéo YouTube) par Daniel Persson
2019-09-06 - Vert.x et OpenAPI par Stephan H Wissel sur Wissel.net Blog
2019-09-09 - Développement natif du cloud - Création de microservices reposants dans IBM Cloud Docs
2019-09-14 - Génération et configuration d'un client API MasterCard sur MasterCard Developers Platform
2019-09-15 - OpenAPI (Swagger) 導入下調べ par Shoichi Kuraoka
2019-09-17 - Tutoriel: documentation des API HTTP4K avec OpenAPI3 par http4k
2019-09-22 - OpenAPI 3 を完全に理解できる本 par @ ota42y
2019-09-22 - API RESTFUL: Tutoriel de la spécification OpenAPI par Amir Lavasani
2019-09-22 - Redéfinir les SDK comme kits de diversité logicielle par Sid Maestre (Xero) à Devrelcon San Francisco 2019
2019-09-23 - Swagger から Générateur OpenAPI で Spring のコードを自動生成 par @Littlefeet à Qiita
2019-09-24 - Eine Sunde était d'abord API MIT! par @janweinschenker au Java Forum Nord
2019-10-09 - OpenAPi-Generator で生成した Go クライアントで Bearer 認証をする par Akira Tanimura
2019-10-10 - Génération automatique de clients REST par Thomas Peyrard, ingénieur logiciel senior chez Criteo dans les conférences technologiques à col (Meetup)
2019-10-12 - OpenAPI 自动生成 Client par 郑泽洲
2019-10-16 - Comment expédier des API plus rapidement? par Simon Guilliams @ Ponicode
2019-10-22 - OpenAPI + Spring Boot (Kotlin) でファイルダウンロード API を作成する par Yuki Furukawa
2019-10-24 - Microprofile OpenAPI - Code d'abord ou concevoir d'abord? par Peter [pɛʃə] Steiner à Eclipsecon Europe 2019
2019-11-06 - Génération de clients API basés sur les spécifications OpenAPI V3 par Dominik Jastrzębski @ 98Elements
2019-11-06 - OpenAPI を利用して自前の API サーバー (Sinatra) を移植した時のメモ par Yasuhiro Abe
2019-11-07 - API First Development avec OpenAPI - vous devriez-vous le pratiquer !? par Nick van Hoof à Devoxx Belgium 2019
2019-11-08 - Jhipster Beyond Crud - API-First for Enterprises par Enrico Costanzi par Enrico Costanzi à Jhipster Conf 2019 à Paris
2019-11-11 - API REST DESTRYScript クライアント par @unhurred
2019-11-11 - Une spécification pour les gouverner toutes - OpenAPI en action par Andreas Litt à Code.Talks 2019
2019-11-13 - Éditeur et générateur OpenAPI 3.0 avec un exemple de démarrage de printemps à simplement comment
2019-11-17 - Liste de lecture YouTube du générateur OpenAPI sur YouTube
2019-11-20 - Introduction à OpenAPI par Lorna Mitchell à Goto Copenhagen 2019
2019-11-20 - Comment générer du code angulaire à partir des spécifications OpenAPI par Anuraj
2019-11-23 - Swagger ではない OpenAPI Spécification 3.0 による API サーバー開発 par Tetsuya Morimoto à Jjug CCC 2019 automne
2019-11-24 - Accélérer le développement de flottement avec OpenAPI et Génération de code de fléchette par Irina Southwell
2019-11-25 - OpenAPi-Generator で手軽にスタブサーバとクライアントの生成 by @ Pochopocho13
2019-11-26 - Cordacon 2019 Faits saillants: serveur tresse et générateur OpenAPI pour les API du client Corda par Adel Rustum à B9LAB
2019-12-03 - A Road to moins Coding: Auto-Genener Apilibrary sur Corda Blog
2019-12-04 - Angular ＋ Nestjs ＋ OpenAPI （Swagger）でマイクロサービスを視野に入れた環境を考える par てらしー
2019-12-05 - Génération de code sur la VM Java par Sean Sullivan
2019-12-17 - Générateur OpenAPI で OAuth2 アクセストークン発行のコードまで生成してみる par Techscore
2019-12-23 - Utilisez ADA pour votre développement Web par Stephane Carrez
2019-12-23 - OpenAPI のスキーマを分割・構造化していく方法 par 小飯塚達也 à Gift, Inc
2020-01-17 - Demo OpenAPI pour Pulp 3.0 Ga par pulpe sur YouTube
2020-01-19 - Pourquoi documenter une API REST comme code? par Rolf Strerefkerk chez Dev Community
2020-01-28 - Remettez votre fanfaron sans serveur avec OpenAPI par Matt Tyler
2020-01-30 - Générateur OpenAPI へのコントリビュート par Yutaka0m
2020-02-01 - Utilisation d'OpenAPI pour maximiser votre expérience Pulp 3 par Dennis Kliban chez Fosdem
2020-02-07 - Pourquoi vous devriez utiliser OpenAPI pour votre conception d'API par Nick van Hoof à la conférence API
2020-02-17 - Rubynetes: Utilisation d'OpenAPI pour valider les configurations de Kubernetes par Neil Wilson à Brightbox
2020-02-20 - Construire des SDK pour l'avenir par Sid Maestre (Xero)
2020-02-27 - Nuxt 利用プロダクトで IE11 と仲良くするための E2E sur Medpeer.co.jp Tech Blog
2020-02-20
2020-03-02 - Comment générer du code angulaire et de printemps à partir des spécifications OpenAPI par Michael Hoffmann
2020-03-02 - Générateur OpenAPI + TypeScript で始める自動生成の型に守られた豊かなクライアント生活 par 五百蔵直樹 au cadeau 株式会社
2020-03-10 - OpenAPI Generator Meetup # 1 par 中野暁人 à OpenAPI Generator Meetup # 1
2020-03-15 - Test de chargement de votre API avec Swagger / OpenAPI et K6
2020-04-13 - 俺的【 OAS 】との向き合い方 (爆速で OpenAPI と友達になろう) dans le blog Optim
2020-04-22 - Introduction au générateur OpenAPI par Kristopher Sandoval dans les API nordiques
2020-04-27 - Comment nous utilisons l'Open API V3 Spécification pour générer automatiquement la documentation de l'API, le code de code et les clients par Tanel Tähepõld
2020-05-09 - OpenAPI でお手軽にモック API サーバーを動かす par Sachie Kamba
2020-05-18 - Spring Boot Rest With OpenAPI 3 by Alfonz Jan Frithz
2020-05-19 - API simples mortes avec API ouverte par Chris Tankersley à Nexmo
2020-05-22 - Client de l'API RESTScript par "sans hâte"
2020-05-28 - 【使用 Lotify + Swagger 建置可用的用的用的用的用的用的用的用的用的用的用的用的用的用的用的用的用的用的用的用的用的用的用的用的用的用的用的用的用的用的 Chatbot Developer Taiwan 第 # 19 小聚 par le développeur de chatbot Taiwan
2020-05-28 - API de construction avec Laravel utilisant OpenAPI par Chris Tankersley à Laracon EU
2020-06-12 - Interopérabilité par construction: Génération de code pour les clients de la tête de flèche par Michele Albano, Brian Nielsen à la Conférence de l'IEEE sur les systèmes cyberphysiques industriels (ICP)
2020-06-23 - 新規サーバーアプリケーションに TypeScript を採用してみた sur Cam Tech Blog
2020-06-29 - Résumé Artefact: Déploiement d'API sur les appareils mobiles Android et les microcontrôleurs par Sergio Laso; Marino Linaje; Jose Garcia-Alonso; Juan M. Murillo; Javier Berrocal à 2020 Conférence internationale de l'IEEE sur l'informatique et les communications omniprésentes (Percom)
2020-07-07 - 5 meilleurs outils de documentation API par Susanna Bouse sur DreamFactory Blog
2020-07-12 - Open API 3.0 の定義から Golang のサーバコードのスケルトンを作成する par @professor (blog Qiita)
2020-07/20
2020-07-23 - Générer le SDK client pour .NET Core à l'aide de l'API Open par Nuno Reis
2020-07-26 - Dart の http_interceptor ライブラリを使うと配列のクエリパラメータが消えてしまう件の応急処置 par @gyamoto
2020-08-01 - Générer des formes réactives angulaires de Swagger / OpenAPI par Martin McWhorter
2020-08-03 - CRIANDO BIBIOTECAS PARA APIS RESTFUL COM OpenAPI, Swagger Editor E OpenAPI Générateur par Everis Brasil (une société de données NTT)
2020-08-19 - マイクロサービスを連携してみよう par 岡井裕矢 (おかいゆうや), 泉勝 (いずみいずみまさるまさるまさるまさるまさるまさるまさるまさるまさるまさるまさるまさるまさる（（シンクイット）））））
2020-08-25 - Générateur OpenAPI と TypeScript で型安全にフロントエンド開発をしている話 sur le blog Smarthth Tech
2020-09-10 - Introduction à OpenAPI avec Instana par Cedric Ziel sur Instana Blog
2020-09-17 - Générez PowerShellsdk en utilisant OpenAPi-Generator par Ghufran Zahidi
2020-09-24 - Comment automatiser la génération de code API (OpenAPI / Swagger) et stimuler la productivité - Tutoriel avec React Native avec Sanjin Celeski
2020-09-25 - Générez le client angulaire OpenAPI par Patric
2020-10-24 - Travailler avec Microsoft Identity - React Native Client par Joseph Guadagno
2020-10-31 - [B2] Spécification OpenAPI 으로 타입 - 세이프하게 API 개발하기: 희망편 VS 절망편 par 최태건 à Feconf 2020
2020-11-05 - Génération automatisée de code REST-API: Wie It-Systeme Miteinander Sprechen par Stefan Rottensteiner sur un blog d'art massif
2020-12-01 - Générateur OpenAPI で Go の API サーバー / クライアントコードを自動生成する par @ Saki-Engineering
2020-12-04 - Mise à l'échelle de la couverture de test du générateur OpenAPI pour plus de 30 langages de programmation par William Cheng à Open Source Summit Japan + Automotive Linux Summit 2020 (diapositives)
2020-12-09 - プロジェクトに Générateur OpenAPI で自動生成された型付き Client API を導入した話 par @yoshifujit
2020-12-15 - Next.js + nestjs + graphql で変化に追従するフロントエンドへ〜ショッピングクーポンの事例紹介 par 小倉陸 à Yahoo! Blog du Japon Tech
2021-01-08 - Bonjour, nouvelle API - Partie 1 de Jeremy Schulman à Major League Baseball
2021-01-18 - 「アプリ開発あるある」を疑うことから始まった、 Client de l'API コードの自動生成【デブスト 2020】 par codezine 編集部
2021-02-05 - REST-API-ROUNDTRIP avec Springdoc et OpenAPI Générateur par Benjamin Klatt à Videe
2021-02-20
2021-03-08 - Générateur OpenAPI 工具的躺坑尝试 par 独家雨天 à csdn 官方博客
2021-03-16 - 如何基于 Swagger 使用 Générateur OpenAPI 生成 JMETER 脚本？ par 高楼 Zee à 腾讯云专栏
2021-03-24 - OpenAPI-Generator-Cli による TypeScript 型定義 par TakeFumi Yoshii
2021-03-28 - Essayer NESTJS Partie 4: Générez les clients TypeScript à partir de documents OpenAPI par Arnaud Cortisse
2021-03-31 - Implémentation d'ouverture du serveur API Open Utilisation du générateur OpenAPI à Baeldung
2021-03-31 - 使用 Générateur OpenAPI 實現 Ouvrez le serveur API à 億聚網
2021-04-19 - Présentation de la spécification OpenAPI de Twilio Beta de Gareth Paul Jones sur Twilio Blog
2021-04-22 - Tirer parti des forces OpenAPI dans un environnement micro-service par Nicolas Jellab sur Unibuddy Technology Blog
2021-04-27 - De zéro à la publication des clients API PowerShell dans la galerie PowerShell en quelques minutes par William Cheng à PowerShell + DevOps Global Summit 2021
2021-05-31 - Flutter で Générateur d'api ouvert (Swagger) を使う par Aakira
2021-06-22 - Documentation de l'API REST et génération de clients avec OpenAPI par Prasanth Gullapalli
2021-07-16 - 銀行事業のサーバーサイド開発について / ligne 京都開発室エンジニア採用説明会エンジニア採用説明会エンジニア採用説明会野田誠人, 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
Documentation
- AsciiDoc: @man-at-home
- HTML Doc 2: @jhitchcock
- Confluence Wiki: @jhitchcock
- PlantUML: @pburls
Configuration
- Apache2: @stkrwork
- k6: @mostafa
Schéma
- 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)
Androïde	@jaz-ah (2017/09)
Sommet
Frapper	@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)
Se cacher
Cristal	@cyangle (2021/01)
Dard	@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)
Élixir	@mrmstn (2018/12)
Orme	@eriktim (2018/09)
Erlang	@tsloughter (2017/11) @jfacorro (2018/10) @robertoaloi (2018/10) @nelsonvides (2024/09)
F#	@nmfisher (2019/05)
Aller	@antihax (2017/11) @grokify (2018/07) @kemokemo (2018/09) @jirikuncar (2021/01) @ph4r5h4d (2021/04) @lwj5 (2023/04)
Graphique	@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)
Perler	@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)
Rubis	@cliffano (2017/07) @zlx (2017/09) @autopp (2019/02)
Rouiller	@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)
Rapide	@jgavris (2017/07) @ehyche (2017/08) @Edubits (2017/09) @jaz-ah (2017/09) @4brunu (2019/11) @dydus0x14 (2023/06)
Manuscrit	@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 Générateur". 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

Licencié sous la licence Apache, version 2.0 (la "licence"); Vous ne pouvez pas utiliser ce fichier sauf conforme à la licence. You may obtain a copy of the License at apache.org/licenses/LICENSE-2.0

Sauf exiger la loi applicable ou convenu par écrit, les logiciels distribués en vertu de la licence sont distribués sur une base «tel quel», sans garantie ou conditions d'aucune sorte, expresse ou implicite. Voir la licence pour la langue spécifique régissant les autorisations et les limitations sous la licence.

Développer

openapi generator

Générateur OpenAPI

Sponsors

Merci à nos sponsors en bronze!

Merci GoDaddy d'avoir parrainé les noms de domaine, Linode pour avoir parrainé le VPS, vérifiez-vous pour le parrainage de la surveillance de l'API et Gradle pour avoir parrainé Develocity

Aperçu

Table des matières

1 - installation

1.1 - Compatibilité

1.2 - Artefacts sur Maven Central

1.3 - Télécharger le pot

Script de lanceur

1.4 - Construire des projets

Utilisateurs NIX

1.5 - Homebrew

1.6 - Docker

Images de docker pré-construites publiques

Image de Docker CLI du générateur OpenAPI

Image docker en ligne du générateur OpenAPI

Développement dans Docker

Dépannage

Exécutez Docker dans Vagrant

1.7 - NPM

2 - Début

3 - utilisation

Pour générer un exemple de bibliothèque client

3.1 - Personnalisation

3.2 - Intégration du flux de travail (Maven, Gradle, Github, CI / CD)

3.3 - Générateur OpenAPI en ligne

3.4 - Informations sur la licence sur le code généré

3.5 - INDÉGRATION IDE

4 - Entreprises / Projets utilisant un générateur OpenAPI

5 - Présentations / vidéos / tutoriels / livres

6 - About Us

6.1 - OpenAPI Generator Core Team

Core Team Members

Template Creator

How to join the core team

6.2 - OpenAPI Generator Technical Committee

Members of Technical Committee

6.3 - History of OpenAPI Generator

Founding Members (alphabetical order):

7 - License