Как получить данные с нескольких API-эндпоинтов и объединить их в один массив по связывающим идентификаторам?

Когда данные о сущности разбросаны по нескольким API, их нужно собрать вместе. Например, список пользователей приходит с одного эндпоинта, а их заказы — с другого. Связующим полем обычно выступает идентификатор (userId, orderId и т.п.).

Параллельные запросы

Первое, что стоит сделать — не ждать ответы последовательно, а запустить их одновременно через Promise.all. Это сокращает общее время ожидания до самого медленного запроса.

Индексация и объединение

Чтобы объединение было быстрым, один из массивов превращают в словарь по ключу. Тогда поиск нужной записи занимает O(1), а общая сложность остаётся линейной.

async function mergeData() {
  const [users, orders] = await Promise.all([
    fetch('/api/users').then(r => r.json()),
    fetch('/api/orders').then(r => r.json())
  ]);

  // Индекс заказов по userId
  const ordersByUser = new Map();
  for (const order of orders) {
    if (!ordersByUser.has(order.userId)) {
      ordersByUser.set(order.userId, []);
    }
    ordersByUser.get(order.userId).push(order);
  }

  // Объединяем
  return users.map(user => ({
    ...user,
    orders: ordersByUser.get(user.id) || []
  }));
}

Обработка ошибок и частичных сбоев

• Promise.all падает целиком при одной ошибке — если это недопустимо, используйте Promise.allSettled.
• Проверяйте, что связующие поля существуют и совпадают по типу (число против строки — частая причина пустых объединений).
• Для больших объёмов данных объединение лучше делать на бэкенде или в SQL через JOIN.

Такой подход применяется в дашбордах, лентах, профилях пользователей и любых экранах, где нужно показать связанные сущности из разных сервисов. Итог: используйте параллельные запросы плюс индекс по ключу — это просто, быстро и предсказуемо по сложности.