BT

InfoQ ホームページ ニュース OpenAPI 3.0プレビュー

OpenAPI 3.0プレビュー

ブックマーク

原文(投稿日:2017/01/27)へのリンク

Open API Initiativeが、2月末に予定しているImplementer DraftとともにOpenAPI 3.0のプレビューを発表した。

新しいOpenAPI 3.0仕様には、以下のような改善点がある。

  • 図にあるように、仕様の全体構造がリファクタリングされて、再利用しやすくなる。
  • JSONスキーマに、oneOfanyOfnotのサポートを追加。
  • パラメータにスキーマが利用可能に。
  • Cookieパラメータが入り、dataFormパラメータがなくなる。
  • Bodyパラメータに独自のエンティティを追加。
  • Contentタイプがネゴシエーション可能に。
  • 複数ホストに対応。
  • セキュリティ定義の簡素化、強化。
  • WebHookがコールバックメカニズムで記述できなくなる。

Open API Initiativeは仕様策定を担当する組織で、2月末に最初のImplementer Draftを計画している。

OpenAPI仕様の目的は以下の通り。

人間とコンピュータの双方が、ソースコード、ドキュメント、ネットワークトラフィックインスペクションにアクセスすることなく、サービスの機能を検出して理解できるように、REST APIに対する標準、言語に依存しないインターフェイスを定義します。OpenAPIを使って適切に定義することで、API利用者は最小限の実装ロジックで、リモートサービスを理解してやりとりすることができます。

OpenAPIは、中立的なガバナンスモデルを持つ新組織を設立したいと、SmartBearからLinux Foundationに寄贈されたSwagger 2.0をもとに作られた。Google、IBM、Microsoftがコントリビューションに関心を示し、Open API Initiativeの創設メンバーとなっている。TDC(Technical Developer Community)はその仕様策定のために結成された組織だ。TDCはメンバーシップを必要とせず、貢献したい個人に開放されている。

OpenAPI仕様は1年かけて「何百ものチケットと何千ものコメント」に取り組み、ほかの大きな変更なしに最終版へと近づいている。

 
 

Rate this Article

Relevance
Style
 
 

この記事に星をつける

おすすめ度
スタイル

こんにちは

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

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

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

コミュニティコメント

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

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

BT

あなたのプロファイルは最新ですか?プロフィールを確認してアップデートしてください。

Eメールを変更すると確認のメールが配信されます。

会社名:
役職:
組織規模:
国:
都道府県:
新しいメールアドレスに確認用のメールを送信します。このポップアップ画面は自動的に閉じられます。