書き直し、npm-scriptsでの例を加筆しました。ページ全体をリロードすることなく画面を更新するのが特徴です。吐き出すことだけに注力出来る事が挙げられます。コードの量も膨大になり、より高い設計力が求められるようになりましたが...。間違わなければそれ以外の点において互いを意識しなくてよいということになります。通じてのみとなるのであれば、インターフェースについての認識は常に合わせておく必要があります。仕様の認識にズレが発覚したとなると悲惨です。サーバーサイドとフロントエンドが同じチームで開発している場合はあまり起こりえない事例ですが、受託案件のようにそれぞれが別の組織で開発する場合においては充分に考えられる話です。そこで重要になってくるのがAPIドキュメントの存在です。APIの仕様が変更になっても常にそれをドキュメントに反映して最新の状態を保つことが出来れば、そのような悲劇の多くは未然に防ぐことが出来るでしょう。APIドキュメントをWebページとしていつでもどこからでもアクセス出来るようにしておけば、これ以上のことはありません。仕様をドキュメントに起こせるほど簡単ではありません。人によって書き方が異なったり定義に過不足が生まれがちです。生成する仕様を定めたものです。インターフェースで定義する内容というのは殆ど決まっているものです。記述フォーマットが明確に定義されているのが特徴です。ドキュメントを書くことが可能となります。公式にあるサンプルをそのまま拝借しています。GETメッセージを取得します。メッセージはプレーンテキストで返ってきます。PUTメッセージを更新します。