BT

OpenAPI 3.0プレビュー

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

原文(投稿日: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

このスレッドのメッセージについて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でリプライする

ディスカッション

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


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

Follow

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

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

Like

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

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

Notifications

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

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

BT