Web API設計ガイドライン | Future Enterprise Arch Guidelines

Web API設計ガイドラインは、世の中のシステム開発プロジェクトのために無償で提供致します。 ただし、掲載内容および利用に際して発生した問題、それに伴う損害については、フューチャー株式会社は一切の責務を負わないものとします。 また、掲載している情報は予告なく変更することがございますので、あらかじめご了承下さい。 はじめに ​本ガイドラインはWeb APIを利用する開発者向けに、RESTライクなWeb APIの主な設計手法をまとめ、システム開発プロジェクトにおける設計のベースラインを提供するために作成された。本ガイドラインを用いることで、開発チームは何を設計すべきか、どのような判断を下すべきかについて共通認識を得ることができる。また、設計の属人性を軽減させ、ナレッジやツールの横展開を容易にすることを狙いにしている。 前提条件 ​本ガイドラインの作成にあたってWeb APIは次の前提を持つと

[akymrk]

"限られたクライアントやシステムと連携""LSUDs（Large Set of Unknown Developers）ではなく、SSKDs（Small Set of Known Developers）が対象""Web APIは基本的に、なるべく「後方互換性」を維持するように機能改修"

[shindo_ryo]

Web API設計でよく議論される論点がまとまっていて非常に良い。いくつか気になるポイントはあるけど、これをベースにしてオープンなディスカッションとかやったら面白そう。

[mano-junki]

作ったよ！