Swagger
https://gyazo.com/6c733f05af40ddb8781753ef9e14051e
Swagger is the world’s largest framework of API developer tools for the OpenAPI Specification(OAS), enabling development across the entire API lifecycle, from design and documentation, to test and deployment.
World's Most Popular API Framework | Swagger
SmartBearが開発をしているOSS
OpenAPI Specification (formerly called the Swagger Specification)
REST APIを記述するフォーマット。YAML
この仕様がSwaggerのコア
Swagger Editor
OpenAPI SpecificationにのっとったYAMLを生成するための補助ツール
YAMLを記述すると構文チェックとリアルタイムプレビューができる
サンプル
http://editor.swagger.io/
YAMLを書くのが遅いときにはStoplight StudioというGUIを使うのがいいらしい
Swagger Codegen
OpenAPI Specificationからクライアントコードを生成するツール
Swagger UI
OpenAPI Specificationからドキュメント・テストフォームを生成するツール
関連
Protocol Buffersで自動生成できる？
https://twitter.com/yugui/status/961096153570906115
参考
SwaggerでRESTful APIの管理を楽にする - Qiita
用語集・ツールの関係性などの基礎知識が書いてある
トップダウン Swagger – PSYENCE:MEDIA
サンプル付き
本当に使ってよかったOpenAPI (Swagger) ツール | Future Tech Blog - フューチャーアーキテクト（2019-10-08）
#API