今月、私たちは無料トレーニング「OpenAPI 3.0でAPIファーストアプローチを採用する」を開催しました。このトレーニングでは、API設計から製品を構築するためのAPIファーストアプローチを採用するために必要なこと、最新バージョンのOpenAPI SpecificationであるOpenAPI 3.0を使用してAPI設計を開発ワークフローに組み込む方法、そしてOASとSwaggerHubを使用して実際のAPI設計を現実世界で効果的に共同作業する方法について説明しました。
APIファーストアプローチとは、アプリケーション用に最初に構築されるインターフェースをAPIとすることです。このアプローチは、製品を構築する前に、ターゲットオーディエンスに高い価値を提供するAPIを構築することを強制します。これにより、開発者と組織は、製品の責任と失敗を最小限に抑え、価値を最大化し、異なるプラットフォームやチャネルでの将来の製品の成功に備えることができます。
OpenAPI Specification (旧Swagger Specification) は、APIファーストの考え方と密接に関連しています。OpenAPI Specificationを使用すると、チームは消費者中心でアプリケーションに偏らない、技術にとらわれないAPIインターフェースを設計でき、同時に内部関係者との同期を維持できます。OpenAPIインターフェースはAPIの機能を定義し、製品とともに成長・進化することができます。
ウェビナーの全録画は以下でご覧いただけます。また、スライドのコピーはこちらからダウンロードできます。
以下は、ウェビナーで取り上げた内容の概要と、各トピックをどこで取り上げたかの詳細です
- APIファーストアプローチとは?[1:30]
- APIファーストアプローチを採用する利点 [8:05]
- APIファーストアプローチを採用するためのガイドライン [14:20]
- APIファーストアプローチにおけるOpenAPI 3.0の役割 [24:40]
- OpenAPIでAPIファーストアプローチを実装する [31:50]
- SwaggerHubでOpenAPI 3.0を使用してAPIを設計する [34:30]
- Q&Aと追加リソース [53:00]
今日からOpenAPI 3.0でAPIの設計とドキュメント作成を始めましょう。SwaggerHubを試す。