テンプレートエンジンからAPIに移行するときの仕様について

Question

これまでWebフレームワークに搭載されているビューのテンプレートエンジンを使ってシステムを開発していたのですが、
フロントエンドをSPA化する為、API形式に移行しようと思っています。

その際のAPIの仕様をどうすべきかで悩んでいます。

テンプレートエンジンの時は1画面につき、1つのコントローラーのメソッドに対応させていました。
同様に、1つのAPIのみで1画面に対するエンドポイントとするのは問題ないのでしょうか。

1画面の動作を複数のAPIを構成させようとすると、APIの乱発で負荷が余計にかかるなどの不都合が発生したりするのではないかとも思っているのですが、どのように対処するのがベターなのでしょうか。

例)
既存の画面:
・モデルAに関するデータの更新フォーム
・モデルBに登録されているデータ一覧表示（設定変更可能）
・更新ボタンで上記2つが更新される

上記のような画面構成だと2つのコントローラーのエンドポイントで対応できますが、これをRestAPI化するとして、
・モデルAのデータ取得
・モデルAのデータ更新
・モデルBの一覧データ取得
・モデルBの一覧データのうち、複数件を更新

４種類のAPIが必要になってくるということなのでしょうか。

Answer 1

比較軸の一つは「モノリシック」と「マイクロサービス」の比較とほぼ似通ったものになると思います。
確認してみては？

Comments

[退会済みユーザー]

ご回答ありがとうございます。
理解が曖昧なので、例を追記しました。
「モノリシック」と「マイクロサービス」の比較というのは、必ずしも複数のAPIで対応する必要はないということなのでしょうか。

Answer 2

一つのAPIを場合分けして色々やるよりは、
内容べつにAPIを書くのがわかりやすく、混乱しにくく、よいのではと思います

Comments

[退会済みユーザー]

ご回答ありがとうございます。
理解が曖昧なので、例を追記しました。
1画面を構成する各機能別にAPIを小分けにするということなのでしょうか。

[winterboum]

機能の意味次第ですが、多分そうです。
ボタンを押すとかデータを入れるとかをトリガーにして何かするのでしょうから、それ毎に、という意味です

[退会済みユーザー]

追加でお伺いしたいのですが、モデルAとモデルB(モデルAのIDを外部キーで持つ)が一対多の関係だった場合、
Rest APIで最初にデータを登録するときは、モデルAを登録後にモデルBを登録させるといったような非同期処理をフロント側で実装する必要があるという形になるのでしょうか。

[winterboum]

ごめん、このコメント気が付かなかった。
AとB達とを一緒に送るという前提で
API側で処理させればよいです

[退会済みユーザー]

ありがとうございます！
理解が深まりました。