Главная страница>Связанные с программированием>Другой исходный код
Скачать

Генератор OpenAPI

Мастер ( 7.11.0 ):

Если вы хотите внести свой вклад, пожалуйста, обратитесь к рекомендациям и списку открытых задач.

‼ ️ Чтобы перейти из Swagger Codegen в генератор OpenAPI, обратитесь к руководству по миграции ‼ ️

? Для получения дополнительной информации, пожалуйста, обратитесь к странице Wiki и FAQ?

? Электронная книга «Руководство для начинающих по генерации кода для API REST» является хорошей отправной точкой для начинающих?

️ Если спецификация OpenAPI, шаблоны или любой вход (например, параметры, переменные среды) получены из ненадежного источника или среды, убедитесь, что вы просмотрели эти входы перед использованием генератора OpenAPI для генерации клиента API, заглушки или документации сервера, чтобы избежать Потенциальные проблемы безопасности (например, инъекция кода). Для уязвимостей безопасности, пожалуйста, свяжитесь с [email protected]. ️

‼ ️ Оба «инструменты OpenAPI» (https://openapitools.org - родительская организация генератора Openapi) и «Generator OpenAPI» не связаны с инициативой OpenAPI (OAI) ‼ ️

Спонсоры

Если вы обнаружите, что Generator OpenAPI полезным для работы, пожалуйста, попросите вашу компанию поддержать этот проект с открытым исходным кодом, став спонсором. Вы также можете отдельно спонсировать проект, став покровителем.

Спасибо нашим бронзовым спонсорам!

Спасибо, Godaddy, за спонсирование доменных имен, Linode за спонсирование VPS, проверьте, чтобы спонсировать мониторинг API и Gradle для спонсирования Develocity

Обзор

Generator OpenAPI позволяет генерацию клиентских библиотек API (Generation SDK), заглушки сервера, документация и конфигурация автоматически сдаются спецификации OpenAPI (поддерживаются как 2.0, так и 3.0). В настоящее время поддерживаются следующие языки/фреймворки:

Языки/фреймворки
Клиенты API ActionScript , ADA , Apex , Bash , C , C# (.NET 2.0, 3,5 или более поздней версии, .NET STANDATE 1.3 - 2.1, .NET CORE 3.1, .NET 5.0. Библиотеки: RestSharp, Generichost, httpclient), C ++ (Arduino, CPP, CPP, CPP. -Restsdk, QT5, Tizen, Unreal Engine 4), Clojure , Crystal , Dart , Elixir , Elm , Eiffel , Erlang , Go , Groovy , Haskell (http-client, слуга), Java (apache httpclient 4.x, apche httpclient 5 .x, Jersey2.x, Okhttp, Mrotfit1.x, Mrotfit2.x, Feign, Resttemplate, Resteasy, Vertx, клиентская библиотека Google API для Java, покровительство Rest, Spring 5 Web Client, Spring 6 RestClient, Micropile Rest Client, Helidon ), Jetbrains http Client , Julia , K6 , Kotlin , Lua , N4JS , NIM , Node.js/Javascript ( ES5 , ES6, AngularJs с аннотациями компилятора Google, Perl, типы потока, Apollo Graph , PHP , PowerShell , Python , R , Ruby , Rust (Hyper, Reqwest, Rust-Server), Scala (Akka, Http4s, Scalaz, STTP, Swagger-Async-HttpClient, Pekko), Swift (2.x, 3.x , 4.x, 5.x, 6.x), TypeScript (Angularjs, Angular (9.x - 18.x), Aurelia, Axios, Fetch, Inversive, jQuery, Nestjs, Node, Redux -Query, Rxjs), Xojo , Zapier
Серверные заглушки ADA , C# (ASP.NET CORE, FUNCTIONS AZURE), C ++ (Pistache, Restbed, QT5 QHTTPENGINE), Erlang , F# (Giraffe), Go (Net/http, джин, эхо), Хаскелл (слуга, Yesod), Java (http, gin, echo), Haskell (слуга, Yesod), Java , джин MSF4J, Spring, Undertow, JAX-RS: CDI, CXF, Inclector, Jersey, Resteasy, Play Framework, Pkmst, Vert.x, Apache Camel, Helidon), Julia , Kotlin (Spring Boot, Ktor, Vert.x), Php (Flight, Laravel, Lumen, Mezzio (FKA Zend Expressive), Slim, Silex, Symfony), Python (Fastapi, Flask), Nodejs , Ruby (Sinatra, Rails5), Rust (Rust-Server), Scala (Akka, Finch, Лагом, Игра, Сеска, Скалатра)
API документации генераторы HTML , Confluence Wiki , Asciidoc , Markdown , Plantuml
Файлы конфигурации Apache2
Другие Graphql , Jmeter , Ktorm , MySQL Schema , Postman Collection , Buffer, WSDL , WSDL

Оглавление

  • Генератор OpenAPI
  • Обзор
  • Оглавление
  • 1 - установка
    • 1.1 - совместимость
    • 1.2 - Артефакты на Maven Central
    • 1.3 - Загрузите JAR
    • 1.4 - строительство проектов
    • 1.5 - Домашний
    • 1.6 - Docker
    • 1.7 - NPM
  • 2 - Начало работы
  • 3 - Использование
    • 3.1 - Настройка
    • 3.2 - Интеграция рабочего процесса
    • 3.3 - онлайн -генераторы
    • 3.4 - Информация о лицензии на сгенерированном коде
    • 3.5 - интеграция IDE
  • 4 - Компании/проекты с использованием генератора OpenAPI
  • 5 - презентации/видео/учебные пособия/книги
  • 6 - О нас
    • 6.1 - Основная команда Generator Generator OpenAPI
    • 6.2 - Технический комитет Generator Generator OpenAPI
    • 6.3 - История генератора OpenAPI
  • 7 - Лицензия

1 - установка

1.1 - совместимость

Спецификация OpenAPI претерпела 3 пересмотра с момента начального создания в 2010 году. Проект OpenAPI-Generator имеет следующие совместимости с спецификацией OpenAPI:

Версия Generator OpenAPI Дата выпуска Примечания
7.11.0 (предстоящий незначительный релиз) Снимок 20.12.2024 Незначительный выпуск с нарушениями (с отчетностью)
7.10.0 (последний стабильный релиз) 18.11.2024 Незначительный выпуск с нарушениями (с отчетностью)
6.6.0 11.05.2023 Незначительный выпуск с нарушениями (с отчетностью)
5.4.0 31.01.2022 Незначительный выпуск с нарушениями (с отчетностью)
4.3.1 06.05.2020 Выпуск патча (усовершенствования, исправления ошибок и т. Д.)

Совместимость Spec Spec: 1,0, 1,1, 1,2, 2.0, 3.0, 3.1 (Beta Support)

(Мы не публикуем ежедневную/ночную сборку. Вместо этого используйте снимки)

Для старых выпусков, пожалуйста, обратитесь к странице релиза .

Для обведенных генераторов/библиотек/фреймворков, пожалуйста, обратитесь к этикетке «Вывод» на странице запроса.

1.2 - Артефакты на Maven Central

Вы можете найти наши выпущенные артефакты на Maven Central:

Основной: 

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

Смотрите различные версии артефакта GoNAPI-генератора, доступных на Maven Central.

CLI: 

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

См. Различные версии артефакта OpenAPI-Generator-Cli, доступные на Maven Central.

Плагин Maven: 

< dependency >
    < groupId >org.openapitools</ groupId >
    < artifactId >openapi-generator-maven-plugin</ artifactId >
    < version >${openapi-generator-version}</ version >
</ dependency >
  • Смотрите различные версии артефакта OpenAPI-Generator-Maven-Plugin, доступных на Maven Central.
  • Ридме

Плагин Gradle: 

< dependency >
    < groupId >org.openapitools</ groupId >
    < artifactId >openapi-generator-gradle-plugin</ artifactId >
    < version >${openapi-generator-version}</ version >
</ dependency >
  • См. Различные версии артефакта GoNAPI-генератора-градл-плуги, доступных на Maven Central.
  • Ридме

1.3 - Загрузите JAR

Если вы ищете последнюю стабильную версию, вы можете взять ее прямо с maven.org (как минимум java 11, как минимум):

Расположение JAR: https://repo1.maven.org/maven2/org/openapitools/openapi-generator-cli/7.10.0/openapi-generator-cli-7.10.0.jar

Для пользователей 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

Для пользователей Windows вам нужно будет установить WGET, или вы можете использовать Invoke-Webrequest в PowerShell (3.0+), например, 

 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

После загрузки JAR запустите java -jar openapi-generator-cli.jar help , чтобы показать использование.

Для пользователей Mac, пожалуйста, убедитесь, что Java 11 установлен (Советы: запустите java -version , чтобы проверить версию), и экспортировать JAVA_HOME , чтобы использовать поддерживаемую версию Java: 

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

Скрипт пусковой установки

Одним из недостатков ручной загрузки JAR является то, что вы не будете в курсе последней выпущенной версии. У нас есть сценарий пускового установки в Bin/Utils/OpenAPI-Generator.Cli.SH, который решает эту проблему.

Чтобы установить скрипт запуска, скопируйте содержимое сценария в местоположение на вашем пути и сделайте исполняемый файл сценария.

Пример настройки этого (примечание: всегда оценивайте сценарии, скручиваемые от внешних систем, прежде чем их выполнять). 

 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/

Теперь openapi-generator-cli «установлен». В ходе вызова он запросит репозиторий GitHub для самой недавно выпущенной версии. Если это соответствует последней загруженной JAR, он будет выполняться как обычно. Если будет найдена более новая версия, скрипт загрузит последний выпуск и выполнит его.

Если вам нужно вызвать более старую версию генератора, вы можете определить переменную OPENAPI_GENERATOR_VERSION . Вы можете экспортировать эту переменную, если хотите сохранить определенную версию выпуска.

Примеры: 

 # 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 - строительство проектов

Чтобы построить из источника, вам нужно следующее установлено и доступно в вашем $PATH:

  • Java 11

  • Apache Maven 3.8,8 или более (необязательно)

После клонирования проекта вы можете построить его из Source, используя Maven Wrapper:

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

Nix пользователи

Если вы пользователь NIX, вы можете ввести оболочку Generator OpenAPI, набрав: 

nix develop

Он войдет в оболочку с установленной Java 11.

Direnv поддерживает автоматическую загрузку оболочки NIX Developer, поэтому, если вы также используете Direnv, тип: 

direnv allow

и настраивайте java и mvn с правильными версиями каждый раз, когда вы вводите каталог проекта.

Сборка по умолчанию содержит минимальный статический анализ (через Checkstyle). Чтобы запустить свою сборку с помощью PMD и SpotBugs, используйте профиль static-analysis :

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

1.5 - Домашний

Для установки запустите brew install openapi-generator

Вот пример использования для создания клиента 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/

Чтобы переустановить с новейшим мастером, запустите brew uninstall openapi-generator && brew install --HEAD openapi-generator

Чтобы установить OpenJDK (предварительные условия), пожалуйста, запустите 

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

или загрузите установщик через https://adoptium.net/

Чтобы установить Maven (необязательно), пожалуйста, запустите 

brew install maven

1.6 - Docker

Общественные предварительно построенные изображения Docker

  • https://hub.docker.com/r/openapitools/openapi-generator-cli/ (официальный CLI)
  • https://hub.docker.com/r/openapitools/openapi-generator-online/ (Официальный веб-сервис)

Generator Generator Cli Docker Image

Изображение генератора OpenAPI действует как автономный исполняемый файл. Его можно использовать в качестве альтернативы установке через Homebrew или для разработчиков, которые не могут установить Java или обновить установленную версию.

Чтобы сгенерировать код с помощью этого изображения, вам нужно установить локальное место в качестве тома.

Пример: 

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

Сгенерированный код будет расположен под ./out/go в текущем каталоге.

OpenApi Generator Online Docker Image

Изображение OpenAPI-Generator-Online может действовать как самостоятельное веб-приложение и API для генерации кода. Этот контейнер может быть включен в трубопровод CI и требует как минимум два HTTP -запроса и некоторую оркестровку Docker для доступа к сгенерированному коду.

Пример использования: 

 # 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

Развитие в Docker

Вы можете использовать run-in-docker.sh , чтобы сделать всю разработку. Этот скрипт отображает ваш локальный репозиторий в /gen в контейнере Docker. Это также отображает ~/.m2/repository в соответствующее местоположение контейнера.

Чтобы выполнить mvn package : 

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

Строительные артефакты теперь доступны в вашем рабочем каталоге.

После построения, run-in-docker.sh будет действовать в качестве исполняемого файла для openapi-generator-cli. Чтобы сгенерировать код, вам нужно вывести в каталог в соответствии с /gen (например /gen/out ). Например: 

./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
Поиск неисправностей

Если возникает такая ошибка, просто выполните команду ./mvnw Clean Install -u :

org.apache.maven.lifecycle.lifecycleexecutionexception: не удалось выполнить цель org.apache.maven.plugins: maven-surefire-plugin: 2.19.1: тест (тест по умолчанию) на проекте openapi-генератор: неспособность типа возникала во время выполнения. org.apache.maven.plugins: maven-surefire-plugin: 2.19.1: тест: java.lang.exceptionInitializererror не может быть поднят на java.io.ioexception 

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

Не удалось выполнить цель org.fortasoft: gradle-maven-plugin: 1.0.8: invoke (по умолчанию) на проекте openapi-Generator-gradle-plugin-mvn-wrapper: org.gradle.tooling.buildexception: не удалось выполнить сборку, используя gradle Распределение 'https://services.gradle.org/distribitions/gradle-4.7bin.zip'

Прямо сейчас: нет решения для этого: |

Запустить Docker в Vagrant

Обязательное условие: Установите бродягу и 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

Существует также обертка пакета NPM, доступная для разных платформ (например, Linux, Mac, Windows). (JVM по -прежнему требуется), пожалуйста, см. В Readme проекта для получения дополнительной информации.

Установите его во всем мире, чтобы получить CLI, доступный в командной строке: 

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

Чтобы использовать конкретную версию "OpenAPI-Generator-Cli" 

openapi-generator-cli version-manager set 7.10.0

Или установите его как зависимость от разработки: 

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

Вы также можете использовать местные банки или версии SNAPSHOT .

2 - Начало работы

Чтобы сгенерировать клиент PHP для Petstore.yaml, запустите следующее 

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

(Если вы в Windows, замените последнюю команду на 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 )

Вы также можете скачать JAR (последний релиз) непосредственно с maven.org

Чтобы получить список доступных общих вариантов, пожалуйста, запустите java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar help generate

Чтобы получить список указанных параметров PHP (которые можно передавать в генератор с помощью файла конфигурации через опцию -c ), запустите java -jar modules/openapi-generator-cli/target/openapi-generator-cli.jar config-help -g php

3 - Использование

Чтобы сгенерировать образец клиентской библиотеки

Вы можете построить клиента против Petstore API следующим образом: 

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

(В Windows, пожалуйста, установите Git Bash для Windows, чтобы запустить команду выше)

В этом сценарии используется библиотека по умолчанию, которая является okhttp-gson . Он запустит генератор с этой командой: 

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

с рядом вариантов. Варианты Java задокументированы здесь.

Вы также можете получить параметры с помощью команды help generate (ниже показывает только частичные результаты): 

 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

Затем вы можете скомпилировать и запустить клиент, а также модульные тесты против него: 

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

У других генераторов тоже есть образцы.

3.1 - Настройка

Пожалуйста, обратитесь к настройке.md о том, как настроить выход (например, имя пакета, версия)

3.2 - Интеграция рабочего процесса (Maven, Gradle, Github, Ci/CD)

Пожалуйста, обратитесь к Integration.md о том, как интегрировать генератор OpenAPI с Maven, Gradle, SBT, Bazel, GitHub и CI/CD.

3.3 - онлайн -генератор OpenAPI

Вот общедоступные онлайн -сервисы:

  • Последняя стабильная версия: https://api.openapi-generator.tech
  • Последний мастер: https://api-latest-master.openapi-generator.tech (обновляется с последним мастером каждый час)

Спонсором сервера Linode

(Эти услуги бета и не имеют никакой гарантии на уровень обслуживания)

Пожалуйста, обратитесь к Online.md о том, как запускать и использовать openapi-generator-online -веб-сервис для openapi-generator .

3.4 - Информация о лицензии на сгенерированном коде

Проект Generator OpenAPI предназначен как преимущество для пользователей спецификации API Open. Сам проект имеет лицензию, как указано. Кроме того, пожалуйста, поймите следующие моменты:

  • Шаблоны, включенные в этот проект, подлежат лицензии.
  • Сгенерированный код намеренно не подлежит лицензии родительского проекта

Когда код генерируется из этого проекта, он должен рассматриваться как есть и принадлежит пользователю программного обеспечения. Нет никаких гарантий-экспрессированных или подразумеваемых-для сгенерированного кода. Вы можете делать то, что вы пожелаете с ним, и после создания код является вашей ответственностью и подчиняется условиям лицензирования, которые вы считаете целесообразными.

3.5 - интеграция IDE

Вот список подключаемых подключаемостей IDE, которые интегрируются с генератором OpenAPI:

  • Eclipse: инструменты Codewind OpenAPI для Eclipse от IBM
  • INTELLIJ IDEA: GENTAPI GENERATOR Джим Шуберт
  • INTELLIJ IDEA: Редактор Senya от Senya.io
  • Reprezen Api Studio
  • Visual Studio: REST API -генератор кода клиента от Christian Resma Helle
  • Visual Studio Code: Codewind OpenAPI Инструменты от IBM

4 - Компании/проекты с использованием генератора OpenAPI

Вот некоторые компании/проекты (алфавитный заказ), использующие генератор OpenAPI в производстве. Чтобы добавить свою компанию/проект в список, посетите readme.md и нажмите на значок, чтобы редактировать страницу.

  • Университет Аалборга
  • Акт кодирование
  • Адаптивные решения Ag
  • АДЕССО SE
  • Адьен
  • Агода
  • Авиации
  • Aleri Solutions GmbH
  • Allianz
  • Angular.schule
  • АКОВИЯ
  • Банковская группа Австралии и Новой Зеландии (ANZ)
  • Ардуино
  • Аборт
  • Amazon Web Services (AWS)
  • B <> com
  • 百度营销
  • Пропускная способность
  • Банзай Облако
  • Bimdata.io
  • Bithost Gmbh
  • Bosch Connected Industry
  • Коробка
  • Бреви
  • Бункерная группа
  • Калифорнийский государственный университет, Нортридж
  • Камера
  • Камптокамп
  • Карлсберг Группа
  • CERN
  • Кристофер Квин Консалтинг
  • Cisco
  • Кодецентрический Ag
  • Coinapi
  • Commencis
  • Configcat
  • Cronn Gmbh
  • Кроссовер здоровье
  • Купикс
  • DataDog
  • DB Systel
  • DebyRute.ai
  • DevSupply
  • DMTech GmbH
  • Docspring
  • Дванго
  • Край Импульс
  • Элемент AI
  • Эмбитенов
  • Эминео
  • быстро
  • Фенерго
  • Freee
  • Freshcells
  • Предохранитель
  • Гантнер
  • Genflow
  • Getyourguide
  • Глово
  • ГМО Пепабо
  • Годадди
  • Gumtree
  • Здесь
  • IBM
  • Инстана
  • Межсетех
  • Inquisico
  • JustStar
  • K6.io
  • Кларна
  • Kronsoft Development
  • Kubernetes
  • Landeshauptstadt München - it@m
  • Линод
  • Логикдоп
  • Lumeris
  • LVM Versicherungen
  • MailSlurp
  • Поиск Мантикора
  • Mastercard
  • Médiavision
  • MetasWitch
  • Moonvision
  • MyWorkout
  • Намсор
  • Неужелю
  • Neuerenergy
  • Nokia
  • OneSignal
  • Корпорация по очистке вариантов (OCC)
  • Открытый
  • Открыто
  • Оракул
  • Paxos
  • Плед
  • Plaid, Inc.
  • Pinterest
  • PONICODE
  • Цена
  • Printnanny
  • Прометей/Alertmanager
  • Кавар
  • Qedit
  • Qovery
  • Qulix Systems
  • Раксул
  • Raiffeisen Schweiz Genossenschaft
  • Редхат
  • Reprezen Api Studio
  • Отдых Юнайтед
  • Robocorp
  • Robotinfra
  • Searchapi
  • Смартр
  • Sony Interactive Entertainment
  • Рассеянный
  • Стингрей
  • Сува
  • Svix
  • Telstra
  • Tencent
  • Университет Айзу
  • Tinqin
  • Полупрозрачные APS
  • Платформа езда
  • Tribalscale
  • Трифорк
  • TUI Infotec Gmbh
  • Твилио
  • Twitter
  • Unblu Inc.
  • Veamly
  • VMware
  • WBT-Solutions
  • Wolet
  • WSO2
  • Vouchery.io
  • Xero
  • Yahoo Japan
  • ViaDee
  • Vonage
  • Иту технология
  • Визг
  • Заландо
  • 3ds OutScale

5 - презентации/видео/учебные пособия/книги

  • 2018/05/12 - Генератор OpenAPI - Сообщество
  • 2018/05/15 - Запуск нового проекта с открытым источником Джереми Брессона
  • 2018/05/15 - REST API 仕様から API クライアントやスタブサーバを自動生成する「 Generator openAPI 」オープンソースで公開。Swagger Codegen からのフォーク by publiceKey
  • 2018/06/08 - Swagger Codegen теперь является Generator OpenAPI от Johanneshoppe
  • 2018/06/21 - Подключите свои приложения Jhipster с миром API с Openapi и GRPC от Кристофа Борнета в Jhipster Conf 2018
  • 2018/06/22 - Генератор OpenAPI で Gatling Client を生成してみた at ソモサン
  • 2018/06/27 - Уроки, извлеченные из ведущего проекта с открытым исходным кодом, поддерживающим 30+ языков программирования - Уильям Ченг в Linuxcon + Contactercon + Cloudopen China 2018
  • 2018/07/19 - Вклад Generator Generator OpenAPI QuickStart - RingCentral Go Sdk от Джона Ванга
  • 2018/08/22 - Генератор OpenAPI のプロジェクト構成などのメモ от Yusuke Iinuma
  • 2018/09/12 - Reprezen и Openapi 3.0: Сейчас самое время Майлз Даффин
  • 2018/10/31 - обертка для пакета узлов для GoNAPI -Generator
  • 2018/11/03 - Генератор OpenAPI + Golang + Flutter でアプリ開発 Ryuichi Daigo
  • 2018/11/15 - 基于 openapi3.0 的 yaml 文件生成 java 代码的一次实践 焱魔王 焱魔王 焱魔王 焱魔王 焱魔王 焱魔王
  • 2018/11/18 - Создание кода библиотеки PHP от Openapi от Lorna Jane в блоге Lornajane
  • 2018/11/19 - Openapis повсюду от Джереми Брессона (UNBLU) в Eclipsecon Europe 2018
  • 2018/12/09 - Генератор Openapi をカスタマイズする方法 をカスタマイズする方法 @watiko
  • 2019/01/03 - Вызов службы Swagger от Apex с использованием генератора OpenAPI от Mikkel Flindt Heisterberg
  • 2019/01/13 - Генератор OpenAPI で RESTFUL API の定義書から色々自動生成する by @ky_yk_d
  • 2019/01/20 - Застройка API -контракта с генератором OpenAPI и Connexion от Anil Can Aydin
  • 2019/01/30 - Быстрая разработка приложений с подходом API First с использованием генератора Open -API от Милана Сонкара
  • 2019/02/02 - 平静を保ち、コードを生成せよ 〜 Generator openapi 誕生の背景と軌跡 〜 by 中野暁人 at at at gunma.web #34 スキーマ駆動開発
  • 2019/02/20 - Приключение в Generation Code Openapi V3 от Phil Cluff
  • 2019/02/26 - Служба построения API: Руководство для начинающих от Ratros Y. В блоге Google Cloud Platform
  • 2019/02/26 - Создание API с OpenAPI: продолжение Ratros Y. В блоге Google Cloud Platform
  • 2019-03-07-Генератор OpenAPI で Spring Boot と Angular をタイプセーフに繋ぐ Tomofumi Chiba
  • 2019-03-16-Быстрое введение в ручное ручное открытие V3 от Vados на Vadosware
  • 2019-03-25-Доступ к любой службе отдыха с SAP S/4HANA Cloud SDK от Alexander Duemont
  • 2019-03-25-Generator OpenAPI を試してみる от @amuyikam
  • 2019-03-27-OpenApi3 を使ってみよう！ Go 言語でクライアントとスタブの自動生成まで！ by @gold_kou
  • 2019-04-17-Openapi によるスキーマファースト開発の実施サンプルと Cloud Run について by @yukey1031
  • 2019-04-18-Как использовать OpenAPI3 для разработчика API (Rubykaigi 2019) по @OTA42Y на Rubykaigi 2019
  • 2019-04-29-Руководство для начинающих по генерации кода для API REST (Generator OpenAPI) Уильяма Ченга
  • 2019-05-01-Проектируйте и создайте API REST от Swagger / OpenAPI в Java, Python, C# и еще.
  • 2019-05-17-генерируйте API Spring Boot Rest с использованием Swagger/OpenApi от Antonie Zafirov
  • 2019-05-22-API REST 代码生成指南 (Generator OpenAPI) Уильям Ченг, Синь Мэн
  • 2019-05-24-API REST 代碼生成指南 (Generator OpenAPI) Уильяма Ченга
  • 2019-06-24-Клиенты Kubernetes и Generator Openapi от Уильяма Ченга в Kubernetes Apportor Summits Shanghai 2019
  • 2019-06-28 Инструменты CodeWind OpenAPI на рынке Eclipse от IBM
  • 2019-06-29 Инструменты CodeWind OpenAPI на рынке Visual Studio от IBM
  • 2019-07-04-REST API のためのコード生成入門 (Generator OpenAPI) Уильям Ченг, 中野暁人, 和田拓朗
  • 2019-07-08 - Generator OpenAPI にコントリビュートしたら社名が載った話。 (CAM) - Cam Tech Blog By Cam, Inc.
  • 2019-07-14-Генератор OpenAPI で Python のクライアントライブラリを作成した от yuji38kwmt
  • 2019-07-19-Опыт разработчиков (DX) для проектов с открытым исходным кодом: как привлечь разработчиков и создать растущее сообщество разработчиков Уильямом Ченгом, 中野暁人 на Summit Open Source Summit Japan 2019
  • 2019-08-14-Наше путешествие OpenAPI со стандартизацией SDKs от Sebastian Burgstaller в Bitmovin
  • 2019-08-15-API のコードを自動生成させたいだけなら grpc でなくてもよくない? от M3, Inc.
  • 2019-08-22-マイクロサービスにおける Web API スキーマの管理 ─ GraphQL 、 Grpc 、 OpenApi の特徴と使いどころ by @Ota42y
  • 2019-08-24-Swagger ドキュメントから Generator openapi を使ってモックサーバー作成 坂本正義 坂本正義
  • 2019-08-29-Openapi 初探 By Peakxie at 腾讯云社区
  • 2019-08-29-全面进化 ： Kubernetes CRD 1.16 GA 前瞻 от Min Kim в блоге ServiceMesher
  • 2019-09-01-Создание сервера PHP-SLIM с использованием OpenAPI (YouTube Video) от Daniel Persson
  • 2019-09-06-Vert.x и Openapi от Stephan H Wissel в блоге Wissel.net
  • 2019-09-09-Облачное развитие-Создание Restful Microservices в облачных документах IBM
  • 2019-09-14-генерирование и настройка клиента API MasterCard на платформе разработчиков MasterCard
  • 2019-09-15-Openapi (Swagger) 導入下調べ от Shoichi Kuraoka
  • 2019-09-17-Учебное пособие: документирование API HTTP4K с OpenAPI3 от http4k
  • 2019-09-22-Openapi 3 を完全に理解できる本 by @ota42y
  • 2019-09-22-APIS RESTFUL: Учебное пособие по спецификации OpenAPI от Amir Lavasani
  • 2019-09-22-Переопределение SDK в качестве наборов разнообразия программного обеспечения Sid Maestre (Xero) в Devrelcon San Francisco 2019
  • 2019-09-23-Swagger から Generator openapi で Spring のコードを自動生成 by @littlefeet в Qiita
  • 2019-09-24-Eine Stunde был первым MIT API! @janweinschenker на Java Forum Nord
  • 2019-10-09-Генератор OpenAPI で生成した Go クライアントで Носитель Akira Tanimura
  • 2019-10-10-Автоматическое поколение клиентов отдыха от Томаса Пейрарда, старшего инженера по программированию в Criteo в полных технических переговорах (Meetup)
  • 2019-10-12-OpenAPI 自动生成 Клиент по 郑泽洲
  • 2019-10-16-Как быстрее отправить APIS? Саймон Гильямс @ PONICODE
  • 2019-10-22-Openapi + Spring Boot (Kotlin) でファイルダウンロード API を作成する от Юки Фурукава
  • 2019-10-24 - микропрофиль OpenAPI - код сначала или сначала дизайн? Питер [Pɛʃə] Штайнер в Eclipsecon Europe 2019
  • 2019-11-06-генерирование клиентов API на основе спецификаций OpenAPI V3 Dominik Jastrzębski @ 98Elements
  • 2019-11-06-Openapi を利用して自前の API サーバー (синатра) を移植した時のメモ от Yasuhiro Abe
  • 2019-11-07 - API First Development с OpenAPI - вы должны практиковать это!? Ник ван Коуф в Devoxx Belgium 2019
  • 2019-11-08-Jhipster Beyond Crud-Api-Pirst для предприятий Энрико Костанци Энрико Костанци на Jhipster Conf 2019 в Париже
  • 2019-11-11-TypeScript Rest API クライアント @unhurried
  • 2019-11-11 - Одна спецификация, чтобы управлять ими все - openapi в действии Андреас Литт на code.talks 2019
  • 2019-11-13-Редактор и генератор OpenAPI 3.0 с примером Spring Boot At Ary How
  • 2019-11-17-Playlist Playlist YouTube Generator Generator OpenAPI на YouTube
  • 2019-11-20-Введение в Openapi от Lorna Mitchell в Goto Copenhagen 2019
  • 2019-11-20-Как генерировать угловой код из спецификаций OpenAPI с помощью Anuraj
  • 2019-11-23-Swagger ではない Specification Specification 3.0 による API サーバー開発 Tetsuya Morimoto на Jjug CCC 2019 Fall Fall
  • 2019-11-24-Ускоренная разработка трепета
  • 2019-11-25-GoNAPI-генератор で手軽にスタブサーバとクライアントの生成 by @Pochopocho13
  • 2019-11-26-Cordacon 2019 Основные моменты: сервер Braid и Generator OpenAPI для API CORDA API от Adel Rustum на B9LAB
  • 2019-12-03-Дорога к меньшему кодированию: автогенерированная апилибрия в блоге Corda
  • 2019-12-04-Angular ＋ Nestjs ＋ Openapi (Swagger) でマイクロサービスを視野に入れた環境を考える でマイクロサービスを視野に入れた環境を考える てらしー てらしー てらしー
  • 2019-12-05-Генерация кода на Java VM от Sean Sullivan
  • 2019-12-17-Generator OpenAPI で OAuth2 アクセストークン発行のコードまで生成してみる TechScore
  • 2019-12-23-Используйте ADA для вашей веб-разработки Стефана Карреса
  • 2019-12-23-Openapi のスキーマを分割・構造化していく方法 by 小飯塚達也 at at dift, inc
  • 2020-01-17-Демонстрация OpenAPI для Pulp 3.0 GA от Pulp на YouTube
  • 2020-01-19-Зачем документировать API REST как код? Рольф Стрифкерк в сообществе Dev
  • 2020-01-28-верните свой Swagger без сервера с Openapi от Мэтта Тайлера
  • 2020-01-30-Генератор OpenAPI へのコントリビュート от Yutaka0m
  • 2020-02-01-Использование OpenAPI для максимизации вашего опыта Pulp 3 Денниса Клибана в FOSDEM
  • 2020-02-07-Почему вы должны использовать OpenAPI для вашего дизайна API от Nick Van Hoof на API Conference
  • 2020-02-17-Rubynetes: Использование OpenAPI для проверки конфигураций Kubernetes от Нила Уилсона в Brightbox
  • 2020-02-20-строительство SDK для будущего Сидом Маестре (Xero)
  • 2020-02-27-Nuxt 利用プロダクトで IE11 と仲良くするための E2E в техническом блоге Medpeer.co.jp
  • 2020-02-29-Оказание поддержки устройств IoT, развернутые в отключенной сельской среде (конференц-газета) Серхио Ласо, Даниэлем Флорес-Мартином, Хуан Луисом Херреракарлосом, Канальджуанским Мануэлем, Муриллоджавье Беррокал
  • 2020-03-02-Как генерировать угловой и пружинный код из спецификации OpenAPI Майкла Хоффмана
  • 2020-03-02-Генератор OpenAPI + TypeScript で始める自動生成の型に守られた豊かなクライアント生活 五百蔵 五百蔵 直樹 at at gift 株式会社
  • 2020-03-10-Meetup Generator Generator OpenAPI #1 от 中野暁人 на Meetup Generator OpenAPI #1
  • 2020-03-15-Загрузка тестирования вашего API с помощью Swagger/OpenAPI и K6
  • 2020-04-13-俺的【 OAS 】との向き合い方 (爆速で Openapi と友達になろう) в блоге Optim
  • 2020-04-22-Введение в генератор OpenAPI от Кристофера Сандовала в северных API
  • 2020-04-27-Как мы используем Open API V3 Speciation для автоматической документации API, кодовых снептов и клиентов Tanel Tähepõld
  • 2020-05-09-Openapi でお手軽にモック API サーバーを動かす от Sachie Kamba
  • 2020-05-18-Spring Boot Rest с Openapi 3 от Alfonz Ян Фрич
  • 2020-05-19-Мертвые простые API с открытым API от Криса Танкерсли в Nexmo
  • 2020-05-22-TypeScript REST API клиент по «невременным»
  • 2020-05-28 - 【使用 Lotify + Swagger 建置可 用的 用的用的 LINE NOTIFY BOT】 - #NIJIA @ DEVELUCTER TAIWAN
  • 2020-05-28-Здание API с Laravel с использованием Openapi от Криса Танкерсли в Лараконе ЕС
  • 2020-06-12-Взаимодействие по строительству: генерация кода для клиентов Arrowhead от Мишель Албано, Брайана Нильсена на конференции IEEE 2020 года по промышленным киберфизическим системам (ICP)
  • 2020-06-23-新規サーバーアプリケーションに TypeScript を採用してみた в блоге Cam Tech
  • 2020-06-29-Аннотация артефакта: развертывание API на мобильных устройствах Android и микроконтроллерах Серхио Ласо; Марино Линадже; Хосе Гарсия-Алонсо; Хуан М. Мурильо; Javier Berrocal в 2020 году Международной конференции IEEE по распространению компьютеров и коммуникации (Percom)
  • 2020-07-07-5 лучших инструментов документации API от Susanna Bouse в Dreamfactory Blog
  • 2020-07-12-Open API 3.0 の定義から Golang のサーバコードのスケルトンを作成する от @professor (блог Qiita)
  • 2020-07-20-клиентские библиотеки Datadog API теперь доступны для Java и Go By Jordan подчиняться в блоге Datadog
  • 2020-07-23-Сгенерировать клиентский SDK для .NET Core с использованием Open API от Nuno Reis
  • 2020-07-26-Дарт の http_interceptor ライブラリを使うと配列のクエリパラメータが消えてしまう件の応急処置 @gyamoto
  • 2020-08-01-генерировать угловые реактивные формы от Swagger/Openapi от Martin McWhorter
  • 2020-08-03-Criando Bibliotecas para apis restful com openapi, редактор Swagger e openapi генератор Everis Brasil (компания NTT Data)
  • 2020-08-19-マイクロサービスを連携してみよう by 岡井 裕矢 (おかい ゆうや), 泉 勝 (いずみ まさる まさる まさる まさる まさる まさる まさる まさる まさる まさる まさる まさる まさる まさる まさる まさる まさる まさる まさる まさる まさる まさる まさる まさる まさる まさる 岡井 岡井 岡井 裕矢 裕矢 岡井 裕矢 岡井 岡井
  • 2020-08-25-Генератор OpenAPI と TypeScript で型安全にフロントエンド開発をしている話 в техническом блоге Smarthr
  • 2020-09-10-Введение в Openapi с Instana Cedric Ziel в блоге Instana
  • 2020-09-17-генерируйте PowerShellsDK с использованием Ghufran Zahidi Ghufran Zahidi
  • 2020-09-24 - Как автоматизировать генерацию кода API (OpenAPI/Swagger) и повышение производительности - Учебное пособие с Native Native с TypeScript от Sanjin Celeski
  • 2020-09-25-генерировать Angular Client OpenAPI от Patric
  • 2020-10-24 - Работа с Microsoft Identity - React Native Client от Joseph Guadagno
  • 2020-10-31-[B2] Спецификация OpenAPI 으로 타입-세이프하게 API 개발하기: 희망편 против 절망편 최태건 최태건 at at feconf 2020
  • 2020-11-05-Автоматизированное поколение кода REST-API: Wie It-Systeme Miteinander Sprechen от Stefan Rottensteiner в Massive Art Blog
  • 2020-12-01-Генератор OpenAPI で Go の api サーバー/クライアントコードを自動生成する by @saki-engineering
  • 2020-12-04-масштабирование тестового покрытия генератора OpenAPI для 30+ языков программирования Уильяма Ченга на Summit Open Source Japan + Automotive Linux Summit 2020 (слайды)
  • 2020-12-09-プロジェクトに Generator OpenAPI で自動生成された型付き API Client を導入した話 @yoshifujit
  • 2020-12-15 - Next.js + NestJS + GraphQLで変化に追従するフロントエンドへ 〜 ショッピングクーポンの事例紹介 by 小倉 陸 at Yahoo! Японский технический блог
  • 2021-01-08-Здравствуйте, New API-Часть 1 от Джереми Шульмана в Бейсболе Высшей лиги
  • 2021-01-18-「アプリ開発あるある」を疑うことから始まった、 API-клиент コードの自動生成【デブスト 2020】 Codezine 編集部
  • 2021-02-05-REST-API-Roundtrip с SpringDOC и Generator Generator Benjamin Klatt в Viadee
  • 2021-02-17-REST-API-ROUNDTRIP с SpringDOC и Generator OpenAPI от Cloud @Viadee
  • 2021-03-08-Генератор OpenAPI 工具的躺坑尝试 独家雨天 独家雨天 at csdn 官方博客
  • 2021-03-16-如何基于 Swagger 使用 Generator openapi 生成 jmeter 脚本？ 高楼 Zee at 腾讯云专栏 腾讯云专栏
  • 2021-03-24-OpenAPI-Generator-Cli による TypeScript 型定義 Tablefumi yoshii
  • 2021-03-28-Попробуйте NESTJS Часть 4: генерировать клиентов TypeScript из документов OpenAPI от Arnaud Cortisse
  • 2021-03-31-Откройте реализацию сервера API с использованием генератора OpenAPI в Baeldung
  • 2021-03-31-使用 Generator OpenAPI 實現 Открыть сервер API по адресу 億聚網
  • 2021-04-19-Представление спецификации Twilio OpenAPI Бета Гарета Пола Джонса в блоге Twilio
  • 2021-04-22-Использование сильных сторон OpenAPI в среде с микро-сервисом от Nicolas Jellab в блоге Unibuddy Technology
  • 2021-04-27-От нуля до публикации клиентов PowerShell API в галерее PowerShell в течение нескольких минут от Уильяма Ченга в PowerShell + Devops Global Summit 2021
  • 2021-05-31-Flutter で Открыть генератор API (Swagger) を使う от Aakira
  • 2021-06-22-Документация по API REST и генерация клиента с OpenAPI от 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
  • Документация
    • AsciiDoc: @man-at-home
    • HTML Doc 2: @jhitchcock
    • Confluence Wiki: @jhitchcock
    • PlantUML: @pburls
  • Конфигурация
    • 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
Ада @stcarrez (2018/02) @michelealbano (2018/02)
Android @jaz-ah (2017/09)
Вершина
Избиение @frol (2017/07) @bkryza (2017/08) @kenjones-cisco (2017/09)
В @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)
Клоджюр
Кристалл @cyangle (2021/01)
Дрэк @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)
Эликсир @mrmstn (2018/12)
Вере @eriktim (2018/09)
Эрланг @tsloughter (2017/11) @jfacorro (2018/10) @robertoaloi (2018/10) @nelsonvides (2024/09)
F# @nmfisher (2019/05)
Идти @antihax (2017/11) @grokify (2018/07) @kemokemo (2018/09) @jirikuncar (2021/01) @ph4r5h4d (2021/04) @lwj5 (2023/04)
Graphql @renepardon (2018/12)
Groovy
Хаскелл
Ява @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)
Джулия @tanmaykm (2023/01)
Котлин @dr4ke616 (2018/08) @karismann (2019/03) @Zomzog (2019/04) @andrewemery (2019/10) @4brunu (2019/11) @yutaka0m (2020/03) @stefankoppier (2022/06) @e5l (2024/10)
Луа @daurnimator (2017/08)
N4JS @mmews-n4 (2023/03)
Ним
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)
Питон @cbornet (2017/09) @tomplus (2018/10) @krjakbrjak (2023/02) @fa0311 (2023/10) @multani (2023/10)
Ведущий @Ramanth (2019/07) @saigiridhar21 (2019/07)
Рубин @cliffano (2017/07) @zlx (2017/09) @autopp (2019/02)
Ржавчина @frol (2017/07) @farcaller (2017/08) @richardwhiuk (2019/07) @paladinzh (2020/05) @jacob-pro (2022/10)
Скала @clasnake (2017/07), @shijinkui (2018/01), @ramzimaalej (2018/03), @chameleon82 (2020/03), @Bouillie (2020/04) @fish86 (2023/06)
Быстрый @jgavris (2017/07) @ehyche (2017/08) @Edubits (2017/09) @jaz-ah (2017/09) @4brunu (2019/11) @dydus0x14 (2023/06)
Машинопись @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)
Питон @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 Генератор". 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

Лицензировано по лицензии Apache, версия 2.0 («Лицензия»); Вы не можете использовать этот файл, кроме как в соответствии с лицензией. You may obtain a copy of the License at apache.org/licenses/LICENSE-2.0

Если это не требуется применимого законодательства или не согласовано в письменной форме, программное обеспечение, распространяемое по лицензии, распределяется по основам «как есть», без каких -либо гарантий или условий, явных или подразумеваемых. См. Лицензию для конкретного языка, регулирующих разрешения и ограничения по лицензии.

Расширять
Дополнительная информация
Связанные приложения
Рекомендуем вам
Связанные новости Все