APIの複数呼び出しについて理解しよう

2024年7月2日2024年8月20日

最近のアプリケーション開発において、API（Application Programming Interface）の利用は欠かせない要素となっています。

特に複数のAPIを効率よく呼び出すための手法や注意点について理解しておくことは重要です。

APIの複数呼び出しのシナリオ

よくあるシナリオとして、次のようなものがあります。

複数の外部サービスからデータを取得する必要がある場合。
大規模なデータを複数の小フェッチに分割して取得する場合。
異なるAPIエンドポイントに対して非同期にリクエストを行う場合。

API呼び出しの並列処理

APIの複数呼び出しを効率化するための一つの方法として、並列処理があります。

例えば、JavaScriptではPromisを利用して以下のように実装できます。


const fetchData1 = fetch('https://api.example.com/data1');
const fetchData2 = fetch('https://api.example.com/data2');
const fetchData3 = fetch('https://api.example.com/data3');

Promise.all([fetchData1, fetchData2, fetchData3])
  .then(responses => {
    return Promise.all(responses.map(response => response.json()));
  })
  .then(data => {
    console.log(data);
  })
  .catch(error => {
    console.error('エラーが発生しました', error);
  });

注意点とベストプラクティス

APIの複数呼び出しに際して、以下の点に注意することが重要です。

リクエスト頻度の制限： 多くのAPIプロバイダーは、一定時間内のリクエスト数に制限を設けています。
これを超えるとリクエストが拒否される可能性があるため、リクエスト頻度を管理する必要があります。
エラーハンドリング： 一つのリクエストが失敗した場合でも、他のリクエストが正しく処理されるようにする必要があります。
Promise.allに対する代替手法として、Promise.allSettledを使うと便利です。
接続の制限： ブラウザやネットワーク環境によって一度に開ける接続の数に制限があることがあります。
大量のAPIを同時に呼び出す場合は、これを考慮する必要があります。

Promise.allSettledを使った例

すべてのPromiseが解決または拒否されるのを待つには、Promise.allSettledを使用すると良いでしょう。


const fetchSettledData1 = fetch('https://api.example.com/data1');
const fetchSettledData2 = fetch('https://api.example.com/data2');
const fetchSettledData3 = fetch('https://api.example.com/data3');

Promise.allSettled([fetchSettledData1, fetchSettledData2, fetchSettledData3])
  .then(results => {
    results.forEach((result) => {
      if (result.status === 'fulfilled') {
        console.log('データ取得成功:', result.value);
      } else {
        console.error('データ取得失敗:', result.reason);
      }
    });
  });