APIの設計において、開発者にとっての使い勝手や、提供者のメンテナンス・拡張のしやすさに配慮することはとても重要です。
記事では、綺麗なAPIを設計するために配慮しておくべき５つのルールが紹介されています。

MicrosoftやGoogle、IBM等によって立ち上げられた「Open API Initiative」という団体が、REST APIの仕様書を定義するための標準フォーマットとして、このSwaggerを推奨しています。

これまでRESTが主流であったものの、規約が曖昧名上に周知されていないことや、N+1クエリ問題のように特定のフィールドのデータを取得する際何度もクエリを取得する必要があるため値を返すのに時間がかかってしまうなどの懸念点がありました。