2017年には、OpenAPI仕様の最新バージョンであるOpenAPI 3.0が正式にリリースされました。
これは、2015年にOpenAPI Initiativeに仕様が寄贈されて以来、初のメジャーリリースとなりました。このリリースは、API記述形式の進化、そしてチームが優れたAPIを開発する上でそれらが果たす役割において、重要な節目となります。
OpenAPI 3.0のリリース以来、Swaggerチームは、チームが最新バージョンのOpenAPIを使い始めるのに役立つ新しいリソースの展開に取り組んできました。主要なオープンソースSwaggerプロジェクトの2つ（Swagger-UIとSwagger-Editor）でOAS 3.0の初期サポートをリリースし、またSwaggerHubでAPIをOpenAPI 3.0に設計、文書化、変換するためのサポートもリリースしました。
2018年には、API分野全体でさらに多くのツールがOAS 3.0のサポートを追加すると予想されます。公式リリース以来、APIStrat 2017やAWS re:Inventなどの業界イベントに参加する機会があり、数百ものAPI実務家から、APIの設計と文書化だけでなく、テストやAPIゲートウェイへのデプロイにもOAS 3.0を使用したいという声を聞きました。
チームがOpenAPI 3.0に切り替えるのを支援するために、OpenAPI 3.0の採用を支援するためにまとめたトレーニングとドキュメントの一部を共有したいと思います。
OpenAPI 3.0の新機能について学び、最新リリースがそれをサポートするSwaggerツールに何を意味するのかを確認してください。
詳細はこちら
SwaggerHubは、OpenAPI 3.0をサポートする最初のAPI設計およびドキュメントプラットフォームの1つです。既存の2.0仕様を最新バージョンのOpenAPIに変換することもできます。SwaggerHubでOpenAPI 3.0を使い始める方法を学びましょう。
SwaggerHubでのOAS 3.0サポートの詳細をご覧ください。
OpenAPI 3.0およびSwagger 2.0仕様のドキュメントはSwagger.ioで見つけることができます。更新されたドキュメントには、3.0仕様の更新された構造と新機能の詳細が含まれています。
新しい仕様を学ぶ。
このトレーニングでは、OpenAPI 3.0の最新の改善点について説明します。Swagger開発者エバンジェリストでありOAI TSCのメンバーであるロン・ラトフスキーが、再利用性の向上、パラメータの変更、コンテンツネゴシエーションのサポート、コールバックの記述のサポート、リンク、改善された例、強化されたセキュリティ定義などの主要なアップデートについて解説します。
OAS 3.0の最新機能の詳細をご覧ください。
このトレーニングでは、SwaggerHubでOpenAPI 3.0を使用して新しいAPIを定義するライブデモンストレーションを提供します。OpenAPIの新しい構造がどのように機能するかを実際に確認し、SwaggerHubエディターを使用してOpenAPI 3.0でAPIドキュメントを定義および視覚化する方法のライブデモをご覧ください。
OAS 3.0を使用したAPIの設計と文書化の詳細をご覧ください。
OpenAPIは仕様の正式名称です。この仕様の開発は、Microsoft、Google、IBM、CapitalOneなど、テクノロジー業界のさまざまな分野の30以上の組織が参加するOpenAPI Initiativeによって推進されています。Swaggerツールの開発を主導するSmartbear SoftwareもOpenAPI Initiativeのメンバーであり、仕様の進化を主導しています。
OpenAPIとSwaggerの違いの詳細をご覧ください。
SmartBearのSwagger/SwaggerHubの製品マーケティングマネージャーであるKeshav Vasudevanは、APIStrat 2017でOAIのテクニカルステアリング委員会（TSC）のDarrel Millerと座談会を行い、OpenAPIの最新情報とプロジェクトの現状について議論しました。
会話全文を読む。
その他のリソース
OpenAPI 3.0のリリース以来、新しいOpenAPI 3.0仕様をチームが学び、採用するのに役立つ貴重なリソースがAPI分野全体で数多く公開されています。ここでは、他のAPI組織や実践者からの私たちのお気に入りのいくつかを紹介します。
OpenAPI 3.0を使い始める準備はできましたか？ SwaggerHubでのOAS 3.0サポートの詳細を見る。