Swaggerフレームワークは、APIがライフサイクルに関わるすべての人とマシンが理解し、作業し、統合できる共通言語（OpenAPI Specification）で記述されることを可能にし、ソフトウェアの状況を永遠に変えました。
仕様はフレームワークの核ですが、API開発プロセスを強化するためのツールチェーン全体がその周りにあります。Swaggerフレームワークをより良く実装するための最も人気のある基本的なツールは、Swagger EditorとSwagger UIです。
Swagger UIは、OpenAPI Specification（旧Swagger Specification）に命を吹き込み、ユーザーが読みやすく理解しやすい形式でAPIを視覚化し、操作できるようにしました。もう1つの人気のあるオープンソースプロジェクトであるSwagger Editorは、OpenAPI SpecificationでAPIを設計するための事実上のエディターです。Swagger EditorとUIは、RESTful APIを設計、文書化、視覚化するための標準ツールとなっています。Swagger EditorとUIの組み合わせは、3秒に1回ダウンロードされています。
そして、最後のメジャーアップデートから2年、これらのツールの次のバージョンがついに登場しました。
Swagger EditorとUIの変更点
新しいSwagger EditorとUIは、開発者コミュニティの何万人ものメンバーからのフィードバックを取り入れており、前任者と同様に完全にオープンソースです。これらは、API設計と文書化プロセスにスピードと信頼性をもたらします。ツールのサイズは80%削減され、具体的で堅牢な長大なAPIを設計する際に、よりアジャイルな体験を提供します。また、ユーザーがインターフェースを完全にカスタマイズし、Swaggerコアプラットフォーム上に独自の機能を構築できる拡張メカニズムも導入されています。
新しいSwagger EditorとUIは、ゼロから再設計され、コードが1つの統合コードベースに統合されました。これにより、オープンソースプロジェクトでの作業と貢献が容易になります。この統合された体験は、開発者とエンドユーザーがOpenAPI Specificationで記述されたAPIを設計、エンジニアリング、消費するための共通のフレームワークを確立します。
Swagger EditorとUIの最新バージョンは、今年後半にリリースされる予定の将来のOpenAPI Specification 3.0との互換性のための基盤を築いています。
ご質問がある場合は、FAQセクションをご覧ください。
特定のプロジェクトのリポジトリは以下のとおりです
Swagger-UI: https://github.com/swagger-api/swagger-ui
Swagger-Editor: https://github.com/swagger-api/swagger-editor
Swaggerチームは、3月30日にサンフランシスコのMashape本社で開催されるミートアップで、新しいSwagger EditorとUIのデモを行います。詳細はこちらをご覧ください。