BT

待望のOpenAPI Spec 3.0が7月にリリース

| 作者: Shelby Switzer フォローする 0 人のフォロワー , 翻訳者 sasai フォローする 0 人のフォロワー 投稿日 2017年7月6日. 推定読書時間: 3 分 |

原文(投稿日:2017/06/29)へのリンク

1年を超える開発期間を経て、Open API InstituteはOpenAPI Specification (OAS) v3.0.0 finalを2017年7月中旬にリリースすると発表した。6月30日に終了するオープンコメント期間の後、リリースされることになる。

APIコミュニティはとても熱心に機能を求めてきた開発者と業界リーダーとともに、今回のリリースを見守ってきた。もっとも注目を集めているOAS 3.0の主要機能には、以下が含まれる。

  • コンポーネント
  • 複数ホストのサポート
  • 新しいContentプロパティによるコンテンツネゴシエーション
  • コールバックとWebhookのサポート
  • Linksオブジェクトによるハイパーメディアのヒント
  • JSON SchemaのanyOf、allOf、not機能のサポート改善

仕様が3.0になるのに合わせて、オープンソースコミュニティとベンダーらは、自らのOASツールの前方互換性に取り組んでいる。OASがベースにしているSwagger記述言語の作者であるTony Tam氏は、昨年のInfoQとのインタビューで、破壊的な変更について警告していた。

多くのツールベンダーは、ツールをアップデートすることで2.0と3.0の両方の仕様をサポートできるでしょうが、2.0のツールは3.0仕様ではほとんど動かなくなるでしょう。私たちはツールの実装にすぐれた前方互換性があることを期待し、推奨します。3.0仕様に対する今後のアップデートは、3.xのバージョン番号になるよう非破壊的なものにします。

仕様の技術的方向性に責任をもつ6名からなるグループ、OAS Technical Developer Community (TDC)のメンバーであるDarrel Miller氏は、TDCが今回のリリース準備で大きな課題になったのは時間と優先順位だとInfoQに語った。「幸運なことに、我々には、仕様がどうなるべきかを助けるために何時間もボランティアをしてくれる熱狂的なコミュニティがあります」と彼は言う。「時間とキャパシティは限られており、機能の追加とシンプルさの維持とのバランスをとっていく必要があります。私たちはみな、仕様が複雑になりすぎるとどうなるのかを見てきました。しかし、その複雑さには必ず、その1つの機能を必要としているユーザーがいます。ノーと言うことで難なく受け入れてくれることはめったにありませんが、それは新しい機能にイエスと言うのと同じくらい重要なことです。」

次のバージョンの具体的な計画はまだないが、将来のリリースに何が必要か、TDCは積極的に議論している。3.0における主要な変更について説明した5月のGlueconのワークショップで、Miller氏は実験的にサポートされた機能(再利用可能なグループ、代替スキーマ、オペレーションバージョニング、動的enum)について紹介した。Miller氏によると、オブジェクトのグループの再利用は、将来のアップデートにおける優先度が高い。そして、ユーザーが優れた一貫性のあるツール体験をするために容易でない課題だが、代替スキーマも要望の多いリクエストだ。次のリリースについて、彼は「次のバージョンがどんなものであれ、その待ち時間は、V3になるのにかかった時間よりもずっと短くなると思います」と言う。

 
 

Rate this Article

Adoption Stage
Style
 
 

この記事に星をつける

おすすめ度
スタイル

こんにちは

コメントするには InfoQアカウントの登録 または が必要です。InfoQ に登録するとさまざまなことができます。

アカウント登録をしてInfoQをお楽しみください。

あなたの意見をお聞かせください。

HTML: a,b,br,blockquote,i,li,pre,u,ul,p

このスレッドのメッセージについてEmailでリプライする
コミュニティコメント

HTML: a,b,br,blockquote,i,li,pre,u,ul,p

このスレッドのメッセージについてEmailでリプライする

HTML: a,b,br,blockquote,i,li,pre,u,ul,p

このスレッドのメッセージについてEmailでリプライする

ディスカッション

特集コンテンツ一覧

C# 8の非同期ストリーム

Bassam Alugili 2018年10月11日 午前3時13分

InfoQにログインし新機能を利用する


パスワードを忘れた方はこちらへ

Follow

お気に入りのトピックや著者をフォローする

業界やサイト内で一番重要な見出しを閲覧する

Like

より多いシグナル、より少ないノイズ

お気に入りのトピックと著者を選択して自分のフィードを作る

Notifications

最新情報をすぐ手に入れるようにしよう

通知設定をして、お気に入りコンテンツを見逃さないようにしよう!

BT