REST APIの設計：複数の呼び出しとAPIの単一の呼び出し

モバイルアプリで使用されるeコマースWebサイト用のRest APIを開発しています。

アプリのホームページでは、スライダー、トップブランド、ベストセラー製品、トレンド製品などの複数のリソースを呼び出す必要があります。

API呼び出しを行うための2つのオプション：

シングルコール：

www.example.com/api/GetAllInHome

複数の呼び出し：

www.example.com/api/GetSliders

www.example.com/api/GetTopBrands

www.example.com/api/GetBestSellingProducts

www.example.com/api/GetTrendingProducts

残りのAPI設計に最適なアプローチはどれですか。単一呼び出しか複数呼び出しか、長所と短所を説明してください。

どちらがリクエストに応答するのに時間がかかりますか？

で理論複数の同時呼び出しが同じくらい速く、より柔軟です。

ただし、実際には、ページをロードしてからそのページの各部分をロードすると、結果が返されるまでロードスピナーが表示され、結果は遅くなり、ばらばらになります。

このため、データのAJAXリクエストは控えめに使用する必要があります。ページのセクションが読み込みが遅いか、ページの残りのサイクルとは異なるサイクルで更新する必要がある場合にのみ使用してください。マスターから詳細を表示します。マスターからオプションを選択し、マスターをリロードせずに対応する詳細を表示します。

一般的な設計は、コーディングの柔軟性とマイクロサービスの懸念のために別個のAPIを保持し、Webサイトのデータサーバー側を結合することです。そのため、クライアントは自分のWebサイトに1回だけ呼び出す必要があります。適切なキャッシングを使用したAPI呼び出しは、データセンター内で高速である必要があります。

また、クライアントAPI呼び出しをまったく行わないことを検討してください。HTMLサーバー側を生成するだけです。javascriptシングルページアプリフレームワークは、APIルートを押し下げます。通常、大量の電子商取引サイトに最適なアプローチではありません。

TL; DR：他のすべてのアプリケーションの考慮事項は別として、単一の呼び出しを実行すると、複数の呼び出しを実行するよりも速くなります。呼び出しを非同期で実行すると、ユーザーの観点から特定の操作を完了するために必要な全体の時間（これで十分な場合もあります）を削減できますが、合計すると、複数の呼び出しにかかる時間はさらに長くなります。

ただし、あなたの場合、それが完全なストーリーかどうかはわかりません。

REST APIは、アイディアを一般的にした論文のさまざまな解釈のために、少し曖昧な用語です。しかし、REST APIを構成するものの最もリベラルな解釈でさえ、あなたが持っているものは実際には適合しません。

基本原則は、アクションを実行するリソースがあることです。URIは、関心のあるリソースを識別します。通常、HTTP動詞を使用して、そのリソースに対して何をしたいのかを示します。

特定のケースでは、すべてのメソッドの名前に「get」という単語が含まれています。HTTPリクエストで使用される動詞を変更して、その場所で利用可能なリソースを「取得」することを示す必要があります。

URIスキームは、APIのユーザーが利用できるようにするリソースの論理階層を表す必要があります。そのため、この場合/api/products?category=sliders、製品のコレクションをフィルタリングするようなものを使用することを検討します。これは、クライアントがすべての製品を取得したいときに、クエリ文字列を単に省略できることを意味します。