OpenAPI -Generator
Wenn Sie einen Beitrag leisten möchten, lesen Sie bitte Richtlinien und eine Liste offener Aufgaben.
‼ ️ Um von Swagger CodeGen zum OpenAPI -Generator zu migrieren ‼ ️
? Weitere Informationen finden Sie auf der Wiki -Seite und den FAQs?
? Das eBook Ein Anfängerleitfaden zur Codegenerierung für REST -APIs ist ein guter Ausgangspunkt für Anfänger?
Euen Wenn die OpenAPI -Spezifikation, Vorlagen oder Eingaben (z. B. Optionen, Umgebungsvariablen) aus einer nicht vertrauenswürdigen Quelle oder Umgebung erhalten wird, stellen Sie sicher Potenzielle Sicherheitsprobleme (EG -Code -Injektion). Für Sicherheitslücken wenden Sie sich bitte an [email protected]. Euen
‼ ️ Beide "OpenAPI -Tools" (https://openapitools.org - Die übergeordnete Organisation von OpenAPI Generator) und "OpenAPI -Generator" sind nicht mit OpenAPI Initiative (OAI) verbunden ‼ ️
Sponsoren
Wenn Sie OpenAPI -Generator für die Arbeit nützlich finden, sollten Sie Ihr Unternehmen auffordern, dieses Open -Source -Projekt zu unterstützen, indem Sie Sponsor werden. Sie können das Projekt auch individuell sponsern, indem Sie ein Unterstützer werden.
Vielen Dank an unsere Bronze -Sponsoren!
Vielen Dank an Godaddy, dass Sie die Domainnamen, Linode für das Sponsoring der VPS und die Checky für das Sponsoring der API -Überwachung und Absolventen für das Sponsoring der Entwicklung gesponsert haben
Überblick
OpenAPI Generator ermöglicht die Erzeugung von API -Client -Bibliotheken (SDK -Generation), Serverstubs, Dokumentation und Konfiguration, die automatisch eine OpenAPI -Spezifikation (sowohl 2.0 als auch 3.0 unterstützt). Derzeit werden die folgenden Sprachen/Frameworks unterstützt:
| Sprachen/Frameworks |
---|
API -Clients | ActionScript , ADA , Apex , Bash , C , C# (.NET 2.0, 3.5 oder höher, .NET Standard 1.3 - 2.1, .NET Core 3.1, .NET 5.0. Bibliotheken: restsharp, tenichost, httpclient), C ++ (Arduino, CPP, CPP -RESTSDK, QT5, TIZEN, UNREAL ENGINE 4), Clojure , Crystal , Dart , Elixir , ELM , Eiffel , Erlang , Go , Groovy , Haskell (Http-Client, Diener), Java (Apache Httpclient 4.x, Apache Httpclient 5 .x, Jersey2.x, Okhttp, Retrofit1.x, Retrofit2.x, vorgeordnet, rastTemplate, restEasy, vertx, Google-API-Client-Bibliothek für Java, REST-ARTEURDE, FRINDE 5 Web Client, Frühling 6 Restclient, Microprofile Rast Client, Helidon ) ., Php , Powershell , Python , R , Ruby , Rost (Hyper, Reqwest, Rost-Server), Scala (Akka, Http4s, Scalaz, STTP, Swagger-Async-Httpclient, Pekko), Swift (2.x, 3.x , 4.x, 5.x, 6.x), TypeScript (AngularJS, Angular (9.x - 18.x), Aurelia, Axios, Fetch, Inversify, JQuery, Nestjs, Knoten, Redux -Query, Rxjs), Xojo , Zapier |
Serverstubs | ADA , C# (ASP.NET CORE, Azure -Funktionen), C ++ (Pistache, Restbett, Qt5 Qhttpengine), Erlang , F# (Giraffe), Go (net/http, gin, echo), Haskell (Diener, Jesod), Java (Java (Java ( MSF4J, Spring, Totow, JAX-RS: CDI, CXF, Inflektor, Jersey, Resteasy, Play Framework, Pkmst, Vert.x, Apache Camel, Helidon), Julia , Kotlin (Spring Boot, Ktor, Vert.x), PHP (Flug, Laravel, Lumen, Mezzio (FKA Zend Expresctive), Slim, Silex, Symfony), Python (Fastapi, Flask), Nodejs , Ruby (Sinatra, Rails5), Rost (Rost-Server), Scala (Akka, Finch, Finch, Finch Lagom, Spiel, Fass, Scalatra) |
API -Dokumentationsgeneratoren | HTML , Confluence Wiki , Asciidoc , Markdown , Plantuml |
Konfigurationsdateien | Apache2 |
Andere | Graphql , JMeter , KTORM , MySQL -Schema , Postmanammlung , Protokollpuffer , WSDL |
Inhaltsverzeichnis
- OpenAPI -Generator
- Überblick
- Inhaltsverzeichnis
- 1 - Installation
- 1.1 - Kompatibilität
- 1.2 - Artefakte auf Maven Central
- 1.3 - Download Jar
- 1.4 - Projekte erstellen
- 1,5 - Homebrew
- 1.6 - Docker
- 1.7 - NPM
- 2 - Einstieg
- 3 - Verwendung
- 3.1 - Anpassung
- 3.2 - Workflow -Integration
- 3.3 - Online -Generatoren
- 3.4 - Lizenzinformationen zum generierten Code
- 3.5 - IDE -Integration
- 4 - Unternehmen/Projekte mit OpenAPI -Generator
- 5 - Präsentationen/Videos/Tutorials/Bücher
- 6 - Über uns
- 6.1 - OpenAPI -Generator -Kernteam
- 6.2 - OpenAPI Generator Technischer Ausschuss
- 6.3 - Geschichte des OpenAPI -Generators
- 7 - Lizenz
1 - Installation
1.1 - Kompatibilität
Die OpenAPI-Spezifikation wurde seit der ersten Schaffung im Jahr 2010 überarbeitet. Das OpenAPI-Generator-Projekt verfügt über die folgenden Kompatibilitäten mit der OpenAPI-Spezifikation:
OpenAPI -Generatorversion | Veröffentlichungsdatum | Notizen |
---|
7.11.0 (bevorstehende Nebenveröffentlichung) Snapshot | 20.12.2024 | Kleinere Veröffentlichung mit Breaking -Veränderungen (mit Fallback) |
7.10.0 (neueste stabile Version) | 18.11.2024 | Kleinere Veröffentlichung mit Breaking -Veränderungen (mit Fallback) |
6.6.0 | 11.05.2023 | Kleinere Veröffentlichung mit Breaking -Veränderungen (mit Fallback) |
5.4.0 | 31.01.2022 | Kleinere Veröffentlichung mit Breaking -Veränderungen (mit Fallback) |
4.3.1 | 06.05.2020 | Patch -Release (Verbesserungen, Fehlerbehebungen usw.) |
OpenAPI -Spezifikation Kompatibilität: 1.0, 1.1, 1,2, 2,0, 3,0, 3,1 (Beta -Unterstützung)
(Wir veröffentlichen nicht täglich/abends Build. Bitte verwenden Sie stattdessen Snapshot)
Für alte Veröffentlichungen finden Sie auf der Release -Seite.
Für dekomissionierte Generatoren/Bibliotheken/Frameworks finden Sie in der Seite "Decommission" auf der Seite Pull -Anfrage.
1.2 - Artefakte auf Maven Central
Sie finden unsere veröffentlichten Artefakte auf Maven Central:
Kern:
< dependency >
< groupId >org.openapitools</ groupId >
< artifactId >openapi-generator</ artifactId >
< version >${openapi-generator-version}</ version >
</ dependency >
Siehe die verschiedenen Versionen des OpenAPI-Generator-Artefakts, das auf Maven Central erhältlich ist.
CLI:
< dependency >
< groupId >org.openapitools</ groupId >
< artifactId >openapi-generator-cli</ artifactId >
< version >${openapi-generator-version}</ version >
</ dependency >
Siehe die verschiedenen Versionen des OpenAPI-Generator-Cli-Artefakts, das auf Maven Central erhältlich ist.
Maven Plugin:
< dependency >
< groupId >org.openapitools</ groupId >
< artifactId >openapi-generator-maven-plugin</ artifactId >
< version >${openapi-generator-version}</ version >
</ dependency >
- Siehe die verschiedenen Versionen des OpenAPI-Generator-Maven-Plugin-Artefakts, das auf Maven Central erhältlich ist.
- Readme
Gradle Plugin:
< dependency >
< groupId >org.openapitools</ groupId >
< artifactId >openapi-generator-gradle-plugin</ artifactId >
< version >${openapi-generator-version}</ version >
</ dependency >
- Siehe die verschiedenen Versionen des OpenAPI-Generator-Gradle-Plugin-Artefakts, das auf Maven Central erhältlich ist.
- Readme
1.3 - Download Jar
Wenn Sie nach der neuesten stabilen Version suchen, können Sie sie direkt von Maven.org (Java 11 Laufzeit mindestens) abrufen:
JAR-Standort: https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/7.10.0/openapi-generator-cli-7.10.0.jar
Für Mac/Linux -Benutzer:
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
Für Windows- Benutzer müssen Sie WGet installieren oder in PowerShell (3.0+), z.
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
Führen Sie nach dem Herunterladen des Glass java -jar openapi-generator-cli.jar help
aus, um die Nutzung zu zeigen.
Für Mac -Benutzer stellen Sie bitte sicher, dass Java 11 installiert ist (Tipps: Führen Sie java -version
aus, um die Version zu überprüfen) und exportieren Sie JAVA_HOME
, um die unterstützte Java -Version zu verwenden:
export JAVA_HOME= ` /usr/libexec/java_home -v 1.11 `
export PATH= ${JAVA_HOME} /bin: $PATH
Launcherskript
Ein Nachteil des manuellen Jar-Downloads ist, dass Sie mit der neuesten veröffentlichten Version nicht auf dem Laufenden halten. Wir haben ein Bash-Launcher-Skript bei Bin/Utils/OpenAPI-Generator.cli.sh, das dieses Problem behebt.
Um das Launcher -Skript zu installieren, kopieren Sie den Inhalt des Skripts an einen Speicherort auf Ihrem Pfad und führen Sie das Skript ausführbar.
Ein Beispiel für die Einrichtung (Hinweis: Bewerten Sie immer Skripte, die aus externen Systemen zusammengerollt wurden, bevor Sie sie ausführen).
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/
Jetzt ist openapi-generator-cli
"installiert". Nach dem Aufruf wird das Github -Repository für die zuletzt veröffentlichte Version abfragen. Wenn dies dem zuletzt heruntergeladenen Glas übereinstimmt, wird es als normal ausgeführt. Wenn eine neuere Version gefunden wird, lädt das Skript die neueste Version herunter und führt sie aus.
Wenn Sie eine ältere Version des Generators aufrufen müssen, können Sie die Variable OPENAPI_GENERATOR_VERSION
entweder Ad -hoc oder global definieren. Sie können diese Variable exportieren, wenn Sie eine bestimmte Versionsversion bestehen möchten.
Beispiele:
# 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 - Projekte erstellen
Um aus der Quelle zu erstellen, benötigen Sie die folgenden und in Ihrem $PATH:
erhältlich:
Nach dem Klonen des Projekts können Sie es mit Maven Wrapper aus der Quelle erstellen:
- Linux:
./mvnw clean install
- Windows:
mvnw.cmd clean install
Nix -Benutzer
Wenn Sie ein NIX -Benutzer sind, können Sie eine OpenAPI -Generatorschale eingeben, indem Sie eingeben:
Es wird eine Shell mit installiertem Java 11 eingeben.
Direnv unterstützt automatisch das Laden der NIX -Entwickler -Shell. Wenn Sie also auch Direnv verwenden, geben Sie also ein:
Lassen Sie java
und mvn
jedes Mal, wenn Sie das Projektverzeichnis eingeben, mit korrekten Versionen eingerichtet.
Der Standardaufbau enthält eine minimale statische Analyse (über Checkstyle). Verwenden Sie das static-analysis
, um Ihren Build mit PMD und Spotbugs auszuführen:
- Linux:
./mvnw -Pstatic-analysis clean install
- Windows:
mvnw.cmd -Pstatic-analysis clean install
1,5 - Homebrew
So installieren Sie brew install openapi-generator
Hier ist eine Beispielnutzung, um einen Ruby -Client zu generieren:
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/
Um mit dem neuesten Meister neu zu installieren, rennen Sie brew uninstall openapi-generator && brew install --HEAD openapi-generator
Um OpenJDK (Voraussetzungen) zu installieren, rennen Sie bitte
brew tap AdoptOpenJDK/openjdk
brew install --cask adoptopenjdk11
export JAVA_HOME= ` /usr/libexec/java_home -v 1.11 `
Oder laden Sie Installer über https://adoptium.net/ herunter
Um Maven (optional) zu installieren, führen Sie bitte aus
1.6 - Docker
Öffentliche vorgefertigte Dockerbilder
- https://hub.docker.com/r/openapitools/openapi-generator-cli/ (offizielle CLI)
- https://hub.docker.com/r/openapitools/openapi-generator-online/ (offizieller Webdienst)
OpenAPI -Generator Cli Docker Bild
Das OpenAPI -Generatorbild fungiert als eigenständige ausführbare Datei. Es kann als Alternative zur Installation über Homebrew oder für Entwickler verwendet werden, die Java nicht installieren oder die installierte Version aktualisieren können.
Um Code mit diesem Bild zu generieren, müssen Sie einen lokalen Standort als Volumen montieren.
Beispiel:
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
Der generierte Code befindet sich unter ./out/go
im aktuellen Verzeichnis.
OpenAPI Generator Online Docker Image
Das OpenAPI-Generator-Online-Bild kann als selbst gehostete Webanwendung und API für das Generieren von Code fungieren. Dieser Container kann in eine CI -Pipeline integriert werden und erfordert mindestens zwei HTTP -Anfragen und einige Docker -Orchestrierung, um auf generierten Code zuzugreifen.
Beispiel Verwendung:
# 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
Entwicklung in Docker
Sie können run-in-docker.sh
verwenden, um die gesamte Entwicklung durchzuführen. Dieses Skript ordnet Ihr lokales Repository /gen
im Docker -Container ab. Es ordnet auch ~/.m2/repository
an den entsprechenden Containerort ab.
Um mvn package
auszuführen:
git clone https://github.com/openapitools/openapi-generator
cd openapi-generator
./run-in-docker.sh mvn package
Build -Artefakte sind jetzt in Ihrem Arbeitsverzeichnis zugänglich.
Nach dem Erstellen fungiert run-in-docker.sh
als ausführbar für OpenAPI-Generator-Cli. Um Code zu generieren, müssen Sie in ein Verzeichnis unter /gen
(z. B. /gen/out
) ausgeben. Zum Beispiel:
./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
Fehlerbehebung
Wenn ein solcher Fehler auftritt, führen Sie einfach den Befehl.
org.apache.maven.lifecycle.lifecycleexexexception: nicht ausführende Ziel org.apache org.apache.maven.plugins: maven-surefire-plugin: 2.19.1: test: java.lang.ExceptionininitializerError kann nicht an java.io.ioxception gegossen werden
./run-in-docker.sh ./mvnw clean install -U
Das Ziel nicht ausführen, organische Ziele: Gradle-Maven-Plugin: 1.0.8: Aufrufen (Standard) auf das Projekt OpenAPI-Generator-Gradle-Plugin-mvn-wrapper: org.gradle.tooling Verteilung 'https://services.gradle.org/distributions/gradle-4.7--Bin.zip'
Im Moment: Keine Lösung für diesen Fall: |
Führen Sie Docker in Vagrant aus
Voraussetzung: Installieren Sie Vagrant und 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
Für verschiedene Plattformen steht auch eine NPM -Paketverpackung zur Verfügung (z. B. Linux, Mac, Windows). (JVM ist noch erforderlich) Weitere Informationen finden Sie in der Readme des Projekts.
Installieren Sie es weltweit, um die CLI in der Befehlszeile verfügbar zu machen:
npm install @openapitools/openapi-generator-cli -g
openapi-generator-cli version
Verwenden Sie eine bestimmte Version von "OpenAPI-Generator-Cli"
openapi-generator-cli version-manager set 7.10.0
Oder installieren Sie es als Dev-Abhängigkeit:
npm install @openapitools/openapi-generator-cli -D
Sie können auch lokal gebaute Gläser oder SNAPSHOT
-Versionen verwenden.
2 - Einstieg
Um einen PHP -Kunden für petstore.yaml zu generieren, führen Sie bitte Folgendes aus
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
(Wenn Sie unter Windows sind, ersetzen Sie den letzten Befehl durch 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
)
Sie können das JAR (neueste Version) auch direkt von maven.org herunterladen
Um eine Liste der verfügbaren allgemeinen Optionen zu erhalten, führen Sie bitte java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar help generate
Um eine Liste der angegebenen PHP-Optionen zu erhalten (die über die Option -c
an den java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar config-help -g php
übergeben werden können java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar config-help -g php
3 - Verwendung
Um eine Beispiel -Client -Bibliothek zu generieren
Sie können einen Kunden wie folgt gegen die Petstore -API erstellen:
./bin/generate-samples.sh ./bin/configs/java-okhttp-gson.yaml
(Installieren Sie unter Windows Git Bash, damit Windows den obigen Befehl ausführen kann.)
Dieses Skript verwendet die Standardbibliothek, die okhttp-gson
ist. Mit diesem Befehl wird der Generator ausgeführt:
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
mit einer Reihe von Optionen. Die Java -Optionen sind hier dokumentiert.
Sie können die Optionen auch mit dem Befehl help generate
abrufen (unten zeigt nur Teilergebnisse):
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
Sie können dann den Client zusammenstellen und ausführen, sowie Unit -Tests dagegen:
cd samples/client/petstore/java/okhttp-gson
mvn package
Andere Generatoren haben auch Proben.
3.1 - Anpassung
Weitere Informationen zum Anpassen der Ausgabe (z. B. Paketname, Version) finden Sie in Customization.md, um die Ausgabe anzupassen (z. B. Paketname)).
3.2 - Workflow -Integration (Maven, Gradle, Github, CI/CD)
In der Integration.md finden Sie unter der Integration von OpenAPI -Generator in Maven, Gradle, SBT, Bazel, Github und CI/CD.
3.3 - Online -OpenAPI -Generator
Hier sind die öffentlichen Online -Dienste:
- Neueste stabile Version: https://api.openapi-generator.tech
- Neuester Master: https://api-latest-master.openapi-generator.tech (aktualisiert mit dem neuesten Master pro Stunde)
Der Server wird von Linode gesponsert
(Diese Dienste sind Beta und haben keine Garantie auf Serviceebene)
Weitere Informationen zum Ausführen und Verwenden openapi-generator-online
finden Sie unter Online.md-einen Webdienst für openapi-generator
.
3.4 - Lizenzinformationen zum generierten Code
Das OpenAPI -Generatorprojekt ist als Vorteil für Benutzer der Open -API -Spezifikation gedacht. Das Projekt selbst hat die Lizenz wie angegeben. Bitte verstehen Sie die folgenden Punkte: Bitte:
- Die in diesem Projekt enthaltenen Vorlagen unterliegen der Lizenz.
- Der generierte Code unterliegt absichtlich nicht der Elternprojektlizenz
Wenn Code aus diesem Projekt generiert wird, wird er als der Benutzer der Software betrachtet und gehören. Es gibt keine Garantien-exprimiert oder impliziert-für generierte Code. Sie können das tun, was Sie damit wünschen, und nach dem Erstellen liegt der Code in Ihrer Verantwortung und unterliegt den Lizenzbegriffen, die Sie für angemessen halten.
3.5 - IDE -Integration
Hier finden Sie eine Liste der mit Community-kontributierten IDE-Plug-Ins, die sich in OpenAPI-Generator integrieren:
- Eclipse: Codewind OpenAPI -Tools für Eclipse von IBM
- Intellij Idee: OpenAPI -Generator von Jim Schubert
- Intellij Idee: Senya -Herausgeber von senya.io
- Reprezen API Studio
- Visual Studio: REST -API -Kundencodegenerator von Christian Resma Helle
- Visual Studio Code: Codewind OpenAPI -Tools von IBM
4 - Unternehmen/Projekte mit OpenAPI -Generator
Hier sind einige Unternehmen/Projekte (alphabetische Reihenfolge) mit OpenAPI -Generator in der Produktion. Um Ihr Unternehmen/Ihr Projekt zur Liste hinzuzufügen, besuchen Sie bitte Readme.md und klicken Sie auf das Symbol, um die Seite zu bearbeiten.
- Aalborg University
- ACT -Codierung
- Anpassende Lösungen AG
- Adesso Se
- Adyen
- Agoda
- Airthings
- Aleri Solutions GmbH
- Allianz
- Angular.schule
- Aqovia
- Australien und neuseeländische Bankengruppe (ANZ)
- Arduino
- Fragen Sie
- Amazon Web Services (AWS)
- B <> com
- 百度营销
- Bandbreite
- Banzai Cloud
- Bimdata.io
- Bithost GmbH
- Bosch verbundene Industrie
- Boxever
- Brevy
- Bunker -Holding -Gruppe
- California State University, Northridge
- NOCKEN
- Camptocamp
- Carlsberg Group
- Cern
- Christopher Queen Consulting
- Cisco
- Codecentric AG
- Coinapi
- Beginn
- ConfigCat
- CRONN GMBH
- Crossover -Gesundheit
- Cupix
- Datadog
- DB -Systel
- Deeporute.ai
- Teuflisch
- Dmtech GmbH
- Docspring
- Dwango
- Randimpuls
- Element ai
- Embotik
- Emineo
- schnell
- Fenergo
- frei
- Neulinge
- Sicherung
- Gantner
- Genflow
- GetyourGuide
- GLOVO
- GMO Pepabo
- GoDaddy
- Gumtree
- Hier
- IBM
- Instana
- Interxion
- Inquisico
- Juststar
- K6.io
- Klarna
- Kronsoft -Entwicklung
- Kubernetes
- Landeshauptstadt münchen - es@m
- Linode
- Logikdrop
- Lumeris
- LVM Versicherungen
- Mailslurp
- Manticore -Suche
- MasterCard
- Médiavision
- Metaswitch
- Moonvision
- My Workout
- Namsor
- Neverfail
- Neuerenergy
- Nokia
- Onesignal
- Options Clearing Corporation (OCC)
- Openet
- OpenValidation
- Orakel
- Paxos
- Plaid
- Plaid, Inc.
- Pinterest
- Ponicode
- Preis
- PrintNanny
- Prometheus/Alertmanager
- Qavar
- Qedit
- Qovery
- Qulix -Systeme
- Raksul
- Raiffeisen Schweiz Genossenschaft
- Redhat
- Reprezen API Studio
- Ruhen vereint
- Robocorp
- Robotinfra
- Searchapi
- Smarthr
- Sony Interactive Entertainment
- Split
- Stachelrochen
- Suva
- Svix
- Telstra
- Tencent
- Die Universität von Aizu
- Tinqin
- Durchscheinende APs
- Reiseplattform
- Tribalscale
- Trifork
- Tui Infotec GmbH
- Dämmerung
- Twitter
- Unblu inc.
- Veamly
- VMware
- WBT-Solutions
- Woleet
- WSO2
- Vouchery.io
- Xero
- Yahoo Japan
- videe
- Vonage
- Yitu -Technologie
- Jaulen
- Zalando
- 3DS übertroffen
5 - Präsentationen/Videos/Tutorials/Bücher
- 2018/05/12 - OpenAPI -Generator - Community Driven で成長するコードジェネレータ von 中野暁人
- 2018/05/15 - Start eines neuen Open -Source -Projekts von Jeremie Bresson
- 2018/05/15 - REST -API 仕様から API クライアントやスタブサーバを自動生成する「 OpenAPI -Generator 」オープンソースで公開。Swagger Codegen からのフォーク von PublicKey
- 2018/06/08 - Swagger Codegen ist jetzt OpenAPI -Generator von Johanneshoppe
- 2018/06/21 - Verbinden Sie Ihre Jhipster -Apps mit der Welt der APIs mit OpenAPI und GRPC von Christophe Bornet bei Jhipster Conf 2018
- 2018/06/22 - OpenAPI -Generator で Gatling Client を生成してみた bei ソモサン
- 2018/06/27 - Lehren aus der Führung eines Open -Source -Projekts, das über 30 Programmiersprachen unterstützt
- 2018/07/19 - OpenAPI -Generatorbeitrag QuickStart - Ringcentral Go SDK von John Wang
- 2018/08/22 - OpenAPI -Generator のプロジェクト構成などのメモ von Yusuke iinuma
- 2018/09/12 - Reprezen und OpenAPI 3.0: Jetzt ist die Zeit von Miles Daffin
- 2018/10/31 - Ein Knotenpaket -Wrapper für OpenAPI -Generator
- 2018/11/03 - OpenAPI -Generator + Golang + Flattern でアプリ開発 von Ryuichi Daigo
- 2018/11/15 - 基于 openAPI3.0 的 yaml 文件生成 java 代码的一次实践 von 焱魔王
- 2018/11/18 - Generieren von PHP -Bibliothekscode von OpenAPI von Lorna Jane im Lornajane Blog
- 2018/11/19 - OpenAPIs sind überall von Jeremie Bresson (UNBLU) bei Eclipsecon Europe 2018
- 2018/12/09 - OpenAPI -Generator をカスタマイズする方法 von @watiko
- 2019/01/03 - Ruf einen Prahlerei von Apex mit OpenAPI -Generator von Mikkel Flindt Heisterberg an
- 2019/01/13 - OpenAPI -Generator で Restful API の定義書から色々自動生成する von @ky_yk_d
- 2019/01/20 - Vertragsfirst -API -Entwicklung mit OpenAPI -Generator und Connexion von Anil Can Aydin
- 2019/01/30 - Schnelle Anwendungsentwicklung mit API Erster Ansatz mit Open -API -Generator von Mailand Sonkar
- 2019/02/02 - 平静を保ち、コードを生成せよ 〜 OpenAPI -Generator 誕生の背景と軌跡 〜 von 中野暁人 at Gunma.Web #34 スキーマ駆動開発
- 2019/02/20 - Ein Abenteuer in OpenAPI V3 Code Generation von Phil Cluff
- 2019/02/26 - Erstellen von API -Diensten: Ein Anfängerhandbuch von Ratros Y. In Google Cloud Platform Blog
- 2019/02/26 - Erstellen von APIs mit OpenAPI: Fortsetzung von Ratros Y. In Google Cloud Platform Blog
- 2019-03-07-OpenAPI-Generator で Federschuh と Angular をタイプセーフに繋ぐ von Tomofumi Chiba
- 2019-03-16-Eine kurze Einführung in Manual OpenAPI V3 von Vados bei Vadosware
- 2019-03-25-Zugriff auf jeden REST-Service mit dem SAP S/4HANA Cloud SDK von Alexander Duemont
- 2019-03-25-OpenAPI-Generator を試してみる von @amuyikam
- 2019-03-27-OpenAPI3 を使ってみよう! Go 言語でクライアントとスタブの自動生成まで! von @gold_kou
- 2019-04-17-OpenAPI によるスキーマファースト開発の実施サンプルと Cloud Run について von @yukey1031
- 2019-04-18-So verwenden Sie OpenAPI3 für den API-Entwickler (Rubykaigi 2019) von @OTA42Y bei Rubykaigi 2019
- 2019-04-29-Ein Anfängerleitfaden zur Codegenerierung für REST-APIs (OpenAPI-Generator) von William Cheng
- 2019-05-01-Entwerfen und generieren Sie eine REST-API von Swagger / OpenAPI in Java, Python, C# und mehr, indem Sie einfach wie wie
- 2019-05-17-Erzeugen Sie die Spring-Boot-REST-API mit Swagger/OpenAPI von Antonie Zafirov
- 2019-05-22-REST-APIS 代码生成指南 (OpenAPI-Generator) von William Cheng, Xin Meng
- 2019-05-24-REST-API 代碼生成指南 (OpenAPI-Generator) von William Cheng
- 2019-06-24-Kubernetes-Clients und OpenAPI-Generator von William Cheng auf Kubernetes-Mitwirkenden Summits Shanghai 2019
- 2019-06-28 Codewind OpenAPI-Tools im Eclipse Marketplace von IBM
- 2019-06-29 Codewind OpenAPI-Tools auf dem Visual Studio Marketplace von IBM
- 2019-07-04-REST-API のためのコード生成入門 (OpenAPI-Generator) von William Cheng, 中野暁人, 和田拓朗
- 2019-07-08 - OpenAPI -Generator にコントリビュートしたら社名が載った話。 (CAM) - Cam Tech Blog von Cam, Inc.
- 2019-07-14-OpenAPI-Generator で Python のクライアントライブラリを作成した von Yuji38kwmt
- 2019-07-19-Entwicklererfahrung (DX) für Open-Source-Projekte: Wie man Entwickler einbezieht und eine wachsende Entwicklergemeinschaft von William Cheng aufbaut, 中野暁人 auf dem Open Source Summit Japan 2019
- 2019-08-14-Unsere OpenAPI-Reise mit Standardisierung von SDKs von Sebastian Burgstaller bei Bitmovin
- 2019-08-15-API のコードを自動生成させたいだけなら GRPC でなくてもよくない? von M3, Inc.
- 2019-08-1
- 2019-08-24-Swagger ドキュメントから OpenAPI-Generator を使ってモックサーバー作成 von 坂本正義
- 2019-08-29-OpenAPI 初探 von Peakxie at 腾讯云社区
- 2019-08-1
- 2019-09-01-Erstellen eines Php-Slim-Servers mit OpenAPI (YouTube Video) von Daniel Persson
- 2019-09-06-Vert.x und OpenAPI von Stephan H Wissel am wissel.net Blog
- 2019-09-09-Cloud-native Entwicklung-Erstellen Sie erholsame Microservices in IBM Cloud-Dokumenten
- 2019-09-14-Generieren und Konfigurieren eines MasterCard-API-Clients auf der Mastercard Developers-Plattform und Konfiguration
- 2019-09-15-OpenAPI (Prahlerei) 導入下調べ von Shoichi Kuraoka
- 2019-09-17-Tutorial: Dokumentieren von HTTP4K-APIs mit OpenAPI3 von http4k
- 2019-09-22-OpenAPI 3 を完全に理解できる本 von @OTA42Y
- 2019-09-22-RESTFOR APIS: Tutorial der OpenAPI-Spezifikation von Amir Lavasani
- 2019-09-22-SDKS als Software-Diversity-Kits von Sid Maestre (Xero) bei Devrelcon San Francisco 2019 neu definieren
- 2019-09-23-Swagger から OpenAPI-Generator で Spring のコードを自動生成 von @littlefeet bei Qiita
- 2019-09-24-Eine Stunde war zuerst mit API! von @janweeinker im Java Forum Nord
- 2019-10-09-OpenAPI-Generator で生成した Go クライアントで Bearer 認証をする von Akira Tanimura
- 2019-10-10-Automatische Generation von Rastkunden von Thomas Pyrard, Senior Software Engineer bei Criteo in Full-Stack Tech Talks (Meetup)
- 2019-10-12-OpenAPI 自动生成 Client von 郑泽洲
- 2019-10-16-Wie kann man APIs schneller versenden? von Simon Guilliams @ Ponicode
- 2019-10-22-OpenAPI + Spring Boot (Kotlin) でファイルダウンロード API を作成する von Yuki Furukawa
- 2019-10-24 - Mikroprofile OpenAPI - zuerst Code oder zuerst Design? von Peter [Pɛʃə] Steiner bei Eclipsecon Europe 2019
- 2019-11-06-Generierung von API-Clients basierend auf OpenAPI V3-Spezifikationen von Dominik Jastrzębski @ 98Lements
- 2019-11-06-OpenAPI を利用して自前の API サーバー (Sinatra) von Yasuhiro Abe
- 2019-11-07 - API Erste Entwicklung mit OpenAPI - Sie sollten es üben!? von Nick Van Hoof bei Devoxx Belgien 2019
- 2019-11-08-Jhipster Beyond Crud-API-First for Enterprises von Enrico Costanzi von Enrico Costanzi bei Jhipster Conf 2019 in Paris
- 2019-11-11-Typscript Rest API クライアント von @Unhurried
- 2019-11-11 - Eine Spezifikation, um sie alle zu regieren - OpenAPI in Aktion von Andreas Litt bei Code.talks 2019
- 2019-11-13-OpenAPI 3.0-Editor und Generator mit einem Spring Boot-Beispiel bei einfach wie
- 2019-11-17-OpenAPI-Generator YouTube Playlist bei YouTube
- 2019-11-20-Einführung in OpenAPI von Lorna Mitchell bei Goto Copenhagen 2019
- 2019-11-20-So generieren Sie Winkelcode aus OpenAPI-Spezifikationen von Anuraj
- 2019-11-23-Swagger ではない OpenAPI-Spezifikation 3.0 による API サーバー開発 von Tetsuya Morimoto bei JJUG CCC 2019 Herbst
- 2019-11-24-Beschleunigung der Flutterentwicklung mit OpenAPI- und Dart-Code-Generation von Irina Southwell
- 2019-11-25-OpenAPI-Generator で手軽にスタブサーバとクライアントの生成 von @pochopocho13
- 2019-11-26-Cordacon 2019 Highlights: Braid Server und OpenAPI-Generator für Corda Client-APIs von Adel Rustum bei B9LAB
- 2019-12-03-ein Weg zu weniger Codierung: Autogenerate-Apilibrary im Corda-Blog
- 2019-12-04-Angular + Nestjs + OpenAPI (Prahlerei )でマイクロサービスを視野に入れた環境を考える von てらしー
- 2019-12-05-Codegenerierung auf dem Java VM von Sean Sullivan
- 2019-12-17-OpenAPI-Generator で OAuth2 アクセストークン発行のコードまで生成してみる von TechScore
- 2019-12-23-Verwenden Sie ADA für Ihre Webentwicklung von Stephane Carrez
- 2019-12-23-OpenAPI のスキーマを分割・構造化していく方法 von 小飯塚達也 at Gift, Inc.
- 2020-01-17-OpenAPI-Demo für Pulp 3.0 Ga durch Zellstoff bei YouTube
- 2020-01-19-Warum eine REST-API als Code dokumentieren? von Rolf Streefkerk bei Dev Community
- 2020-01-28-Holen Sie sich Ihre serverlose Prahlerin mit OpenAPI von Matt Tyler zurück zurück
- 2020-01-30-OpenAPI-Generator へのコントリビュート von Yutaka0m
- 2020-02-01-Verwenden von OpenAPI, um Ihre Zellstoff-3-Erfahrung von Dennis Kliban bei Fosdem zu maximieren
- 2020-02-07-Warum Sie OpenAPI für Ihr API-Design von Nick Van Hoof auf der API-Konferenz verwenden sollten
- 2020-02-17-Rubyndes: Verwenden von OpenAPI zur Validierung von Kubernetes-Konfigurationen von Neil Wilson bei Brightbox
- 2020-02-20-Bauen von SDKs für die Zukunft von Sid Maestre (Xero)
- 2020-02-27-Nuxt 利用プロダクトで IE11 と仲良くするための E2E bei medpeer.co.jp Tech Blog
- 2020-02-29-Unterstützung für IoT-Geräte, die von Sergio Laso, Daniel Flores-Martín, Juan Luis Herreracarlos, Canaljuan Manuel, Murillojavier Berrlokal, in getrennter ländlicher Umwelt (Konferenzpapier) eingesetzt wurden
- 2020-03-02-So generieren Sie Angular & Spring Code aus OpenAPI-Spezifikation von Michael Hoffmann
- 2020-03-02-OpenAPI-Generator + TypeScript で始める自動生成の型に守られた豊かなクライアント生活 nach 五百蔵 直樹 bei Geschenk 株式会社
- 2020-03-10-OpenAPI-Generator Meetup Nr. 1 von 中野暁人 bei OpenAPI Generator Meetup #1
- 2020-03-15-Laden Sie Ihre API mit Prahlerei/OpenAPI und K6 auf
- 2020-04-13-俺的【 OAS 】との向き合い方 (爆速で OpenAPI と友達になろう と友達になろう) im Optim-Blog
- 2020-04-22-Einführung in den OpenAPI-Generator von Kristopher Sandoval in nordischen APIs
- 2020-04-27-So verwenden wir eine Open-API-V3
- 2020-05-09-OpenAPI でお手軽にモック API サーバーを動かす von Sachie Kamba
- 2020-05-18-Federstiefel Ruhe mit OpenAPI 3 von Alfonz Jan Frithz
- 2020-05-19-Tote einfache APIs mit offener API von Chris Tankersley bei Nexmo
- 2020-05-22-Typscript Rest API-Client von "ungehälscht"
- 2020-05-1
- 2020-05-28-Bauen von APIs mit Laravel mit OpenAPI von Chris Tankersley bei Laracon EU
- 2020-06-12-Interoperabilität durch Bau: Code-Generierung für Arrowhead-Kunden von Michele Albano, Brian Nielsen auf der IEEE-Konferenz 2020 über industrielle Cyberphysical Systems (ICPS)
- 2020-06-23-新規サーバーアプリケーションに TypyScript を採用してみた im Cam Tech-Blog
- 2020-06-29-Artefact Abstract: Bereitstellung von APIs auf Android-Mobilgeräten und Mikrocontrollern durch Sergio Laso; Marino Linaje; Jose Garcia-Alonso; Juan M. Murillo; Javier Berrokal bei 2020 IEEE International Conference über Pervasive Computing and Communications (Percom)
- 2020-07-07-5 Beste API-Dokumentationstools von Susanna Bouse im DreamFactory Blog
- 2020-07-12-Öffnen Sie die API 3.0 の定義から Golang のサーバコードのスケルトンを作成する von @Professor (Qiita-Blog)
- 2020-07-20-Datadog-API-Client-Bibliotheken jetzt für Java verfügbar und gehen Sie von Jordan beobachten im Datadog-Blog
- 2020-07-23-Generieren Sie Client SDK für .NET Core mithilfe von Open API von Nuno Reis
- 2020-07-26-Dart の http_interceptor ライブラリを使うと配列のクエリパラメータが消えてしまう件の応急処置 von @gyamoto
- 2020-08-01-Erzeugen Sie eckige Reaktivformen von Prahlerei/OpenAPI von Martin McWhorter
- 2020-08-03-Criando Bibliotecas Para APIs RESTFOR COM OPENAPI, SWARGE EDITOR E OpenAPI Generator von Everis Brasil (NTT-Datenunternehmen)
- 2020-08-19-マイクロサービスを連携してみよう von 岡井 裕矢 (おかい ゆうや), 泉 勝 (いずみ まさる まさる まさる まさる まさる まさる まさる まさる まさる まさる まさる ゆうや ゆうや).
- 2020-08-25-OpenAPI-Generator と TypyScript で型安全にフロントエンド開発をしている話 im Smarthr Tech Blog
- 2020-09-10-Einführung in OpenAPI mit Instana von Cedric Ziel am Instana Blog
- 2020-09-17-Erzeugen Sie PowerShellsdk mit OpenAPI-Generator von Ghufran Zahidi
- 2020-09-24 - So automatisieren Sie die API -Codegenerierung (OpenAPI/Swagger) und steigern Sie die Produktivität - Tutorial mit React Native mit TypeScript von Sanjin Celeski
- 2020-09-25-OpenAPI Angular Client durch Patric erzeugen
- 2020-10-24 - Arbeiten mit Microsoft Identity - Reagieren Sie den nativen Kunden von Joseph Guadagno
- 2020-10-31-[B2] OpenAPI-Spezifikation 으로 타입-세이프하게 api 개발하기: 희망편 vs 절망편 von 최태건 am feconf 2020
- 2020-11-05-Automatisierte Erstellung von Rast-API-Code: IT-System MiteInander Speechen von Stefan Rottensteiner im Massive Art Blog
- 2020-12-01-OpenAPI-Generator で go の api サーバー/クライアントコードを自動生成する von @saki-tousering
- 2020-12-04-Skalierung der Testabdeckung von OpenAPI-Generator für 30+ Programmiersprachen von William Cheng am Open Source Summit Japan + Automotive Linux Summit 2020 (Folien)
- 2020-12-09-プロジェクトに OpenAPI-Generator で自動生成された型付き API-Client を導入した話 von @yoshifujit
- 2020-12-15-Next.js + Nestjs + Graphql で変化に追従するフロントエンドへ ショッピングクーポンの事例紹介 ショッピングクーポンの事例紹介 小倉 陸 陸 at yahoo! Japan Tech Blog
- 2021-01-08-Hallo, neue API-Teil 1 von Jeremy Schulman im Major League Baseball
- 2021-01-18-「アプリ開発あるある」を疑うことから始まった、 API-Client コードの自動生成【デブスト 2020】 nach Codezine 編集部
- 2021-02-05-Rest-api-RoundTrip mit Springdoc und OpenAPI-Generator von Benjamin Klatt bei Videee
- 2021-02-17-Rest-api-RoundTrip mit Springdoc und OpenAPI-Generator von Cloud @viadee
- 2021-03-08-OpenAPI-Generator 工具的躺坑尝试 von 独家雨天 bei CSDN 官方博客
- 2021-03-16-如何基于 Swagger 使用 OpenAPI-Generator 生成 JMeter 脚本? von 高楼 Zee at 腾讯云专栏
- 2021-03-24-OpenAPI-Generator-Cli による TypeScript 型定義 von takefumi yoshii
- 2021-03-1
- 2021-03-31-Implementierung der API-Server mit OpenAPI-Generator bei Baeldung öffnen
- 2021-03-31-使用 OpenAPI-Generator 實現 Open API-Server unter 億聚網
- 2021-04-19-Einführung von Twilios OpenAPI-Spezifikation Beta von Gareth Paul Jones im Twilio Blog
- 2021-04-22-Nutzung von OpenAPI-Stärken in einer Mikro-Service-Umgebung von Nicolas Jellab im Unibuddy Technology Blog
- 2021-04-1
- 2021-05-31-Flattern で Open API-Generator (Prahlerei) を使う von Aakira
- 2021-06-22-REST-API-Dokumentation und Client-Generierung mit OpenAPI von 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
- Dokumentation
- AsciiDoc: @man-at-home
- HTML Doc 2: @jhitchcock
- Confluence Wiki: @jhitchcock
- PlantUML: @pburls
- Konfiguration
- Apache2: @stkrwork
- k6: @mostafa
- Schema
- Avro: @sgadouar
- GraphQL: @wing328 ❤️
- Ktorm: @Luiz-Monad
- MySQL: @ybelenko
- Postman Collection: @gcatanese
- Protocol Buffer: @wing328
- WSDL: @adessoDpd
❤️ = Link to support the contributor directly
How to join the core team
Here are the requirements to become a core team member:
- rank within top 50 in https://github.com/openapitools/openapi-generator/graphs/contributors
- to contribute, here are some good starting points
- regular contributions to the project
- about 3 hours per week
- for contribution, it can be addressing issues, reviewing PRs submitted by others, submitting PR to fix bugs or make enhancements, etc
- must be active in the past 3 months at the time of application
To join the core team, please reach out to [email protected] for more information.
To become a Template Creator, simply submit a PR for new API client (eg Rust, Elixir) or server stub (eg Ruby Grape) generator.
6.2 - OpenAPI Generator Technical Committee
Members of the OpenAPI Generator technical committee shoulder the following responsibilities:
- Provides guidance and direction to other users
- Reviews pull requests and issues
- Improves the generator by making enhancements, fixing bugs or updating documentations
- Sets the technical direction of the generator
Who is eligible? Those who want to join must have at least 3 PRs merged into a generator. (Exceptions can be granted to template creators or contributors who have made a lot of code changes with less than 3 merged PRs)
If you want to join the committee, please kindly apply by sending an email to [email protected] with your Github ID.
Members of Technical Committee
Languages/Generators | Member (join date) |
---|
ActionScript | |
Ada | @stcarrez (2018/02) @michelealbano (2018/02) |
Android | @jaz-ah (2017/09) |
Apex | |
Verprügeln | @frol (2017/07) @bkryza (2017/08) @kenjones-cisco (2017/09) |
C | @zhemant (2018/11) @ityuhui (2019/12) @michelealbano (2020/03) |
C ++ | @ravinikam (2017/07) @stkrwork (2017/07) @etherealjoy (2018/02) @martindelille (2018/03) @muttleyxd (2019/08) |
C# | @mandrean (2017/08) @shibayan (2020/02) @Blackclaws (2021/03) @lucamazzanti (2021/05) @iBicha (2023/07) |
Clojure | |
Kristall | @cyangle (2021/01) |
Pfeil | @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) |
Elixier | @mrmstn (2018/12) |
Ulme | @eriktim (2018/09) |
Erlang | @tsloughter (2017/11) @jfacorro (2018/10) @robertoaloi (2018/10) @nelsonvides (2024/09) |
F# | @nmfisher (2019/05) |
Gehen | @antihax (2017/11) @grokify (2018/07) @kemokemo (2018/09) @jirikuncar (2021/01) @ph4r5h4d (2021/04) @lwj5 (2023/04) |
Graphql | @renepardon (2018/12) |
Groovy | |
Haskell | |
Java | @bbdouglas (2017/07) @sreeshas (2017/08) @jfiala (2017/08) @lukoyanov (2017/09) @cbornet (2017/09) @jeff9finger (2018/01) @karismann (2019/03) @Zomzog (2019/04) @lwlee2608 (2019/10) @martin-mfg (2023/08) |
Java Spring | @cachescrubber (2022/02) @welshm (2022/02) @MelleD (2022/02) @atextor (2022/02) @manedev79 (2022/02) @javisst (2022/02) @borsch (2022/02) @banlevente (2022/02) @Zomzog (2022/09) @martin-mfg (2023/08) |
JMeter | @kannkyo (2021/01) |
Jetbrains HTTP Client | @jlengrand (2023/01) |
Julia | @tanmaykm (2023/01) |
Kotlin | @dr4ke616 (2018/08) @karismann (2019/03) @Zomzog (2019/04) @andrewemery (2019/10) @4brunu (2019/11) @yutaka0m (2020/03) @stefankoppier (2022/06) @e5l (2024/10) |
Lua | @daurnimator (2017/08) |
N4JS | @mmews-n4 (2023/03) |
Nim | |
NodeJS/Javascript | @CodeNinjai (2017/07) @frol (2017/07) @cliffano (2017/07) |
ObjC | |
Ocaml | @cgensoul (2019/08) |
Perl | @wing328 (2017/07) ❤️ @yue9944882 (2019/06) |
PHP | @jebentier (2017/07), @dkarlovi (2017/07), @mandrean (2017/08), @jfastnacht (2017/09), @ybelenko (2018/07), @renepardon (2018/12) |
Powershell | @wing328 (2020/05) |
Python | @cbornet (2017/09) @tomplus (2018/10) @krjakbrjak (2023/02) @fa0311 (2023/10) @multani (2023/10) |
R | @Ramanth (2019/07) @saigiridhar21 (2019/07) |
Rubin | @cliffano (2017/07) @zlx (2017/09) @autopp (2019/02) |
Rost | @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) |
Schnell | @jgavris (2017/07) @ehyche (2017/08) @Edubits (2017/09) @jaz-ah (2017/09) @4brunu (2019/11) @dydus0x14 (2023/06) |
Typoskript | @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 Generator". Please refer to the Q&A for more information.
Founding Members (alphabetical order):
- Akihito Nakano
- Artem Ocheredko
- Arthur Mogliev
- Bartek Kryza
- Ben Wells
- Benjamin Gill
- Christophe Bornet
- Cliffano Subagio
- Daiki Matsudate
- Daniel
- Emiliano Bonassi
- Erik Timmers
- Esteban Gehring
- Gustavo Paz
- Javier Velilla
- Jean-François Côté
- Jim Schubert
- Jon Schoning
- Jérémie Bresson ❤️
- Jörn Ahrens
- Keni Steward
- Marcin Stefaniuk
- Martin Delille
- Masahiro Yamauchi
- Michele Albano
- Ramzi Maalej
- Ravindra Nikam
- Ricardo Cardona
- Sebastian Haas
- Sebastian Mandrean
- Sreenidhi Sreesha
- Stefan Krismann
- Stephane Carrez
- Takuro Wada
- Tomasz Prus
- Tristan Sloughter
- Victor Orlovsky
- Victor Trakhtenberg
- Vlad Frolov
- Vladimir Pouzanov
- William Cheng
- Xin Meng ❤️
- Xu Hui Hui
- antihax
- beatcracker
- daurnimator
- etherealjoy
- jfiala
- lukoyanov
❤️ = Link to support the contributor directly
7 - License
Copyright 2018 OpenAPI-Generator Contributors (https://openapi-generator.tech) Copyright 2018 SmartBear Software
Lizenziert unter der Apache -Lizenz, Version 2.0 (der "Lizenz"); Sie dürfen diese Datei nur in Übereinstimmung mit der Lizenz verwenden. You may obtain a copy of the License at apache.org/licenses/LICENSE-2.0
Sofern nicht nach geltendem Recht oder schriftlich zu vereinbart wird, wird die im Rahmen der Lizenz verteilte Software auf "As is" -Basis ohne Gewährleistung oder Bedingungen jeglicher Art ausdrücklich oder impliziert verteilt. Siehe die Lizenz für die spezifischen Sprachberechtigungen und Einschränkungen im Rahmen der Lizenz.