OpenAPI仕様(旧Swagger仕様)は、RESTful APIを定義するための世界標準として登場しました。API開発でOASを使用する場合、API開発に対する「デザインファースト」と「コードファースト」という2つの重要な考え方が出てきました。
デザインファーストのアプローチは、コードを書く前にAPIの規約を最初に設計することを提唱する、比較的新しいアプローチですが、APIチーム全体で急速に採用されています。デザインファーストのアプローチでは、チームはOASの力を最大限に活用し、API定義をAPI開発の唯一の情報源として使用し、定義を活用してソースコード、ドキュメント、テストケース、さらにはAPIの監視を自動生成できます。
このウェビナーでは、OASに対するデザインファーストのアプローチの利点と、チームがOpenAPI仕様(OAS 3.0)の最新バージョンとSwaggerツールを活用してデザインファーストのアプローチを採用する方法について説明します。
内容
- OASへのさまざまなアプローチの理解
- デザインファーストのアプローチに移行するための手順
- 社内関係者からフィードバックを得るためのレビュープロセスの実装
- OAS 3.0コード生成による設計から開発への移行
- SwaggerHubとソース管理の同期による設計と開発の同期
これらの戦略を今日から活用してください。 SwaggerHubを無料で使い始めましょう。