Как работать с ненадежным внешним REST-сервисом?

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

Основные паттерны устойчивости

• Таймауты (Timeouts): Устанавливают максимальное время ожидания ответа. Это предотвращает бесконечное блокирование вашего потока или соединения.
• Повторные попытки (Retries): При временных ошибках (например, 5xx) запрос повторяется. Важно использовать экспоненциальную задержку (exponential backoff) и джиттер (jitter), чтобы не перегружать целевой сервис.
• Размыкатель цепи (Circuit Breaker): Мониторит количество неудачных запросов. При превышении порога он "размыкает цепь" и мгновенно отклоняет новые вызовы на период тайм-аута, давая сервису время на восстановление.
• Резервный вариант (Fallback): Предоставляет альтернативный ответ, если основной сервис недоступен (например, кешированные данные, значения по умолчанию или вызов другого сервиса).

Практическая реализация

В экосистеме Node.js популярна библиотека axios для HTTP-запросов и axios-retry для повторных попыток. Для Circuit Breaker можно использовать opossum или возможности фреймворков.

const axios = require('axios');
const CircuitBreaker = require('opossum');

// Настройка таймаута для axios
const apiClient = axios.create({ timeout: 5000 });

// Функция для вызова внешнего API
async function fetchExternalData(userId) {
  try {
    const response = await apiClient.get(`https://external.api/users/${userId}`);
    return response.data;
  } catch (error) {
    // Логика обработки ошибок и fallback
    console.error('API call failed:', error.message);
    // Возвращаем закешированные или дефолтные данные
    return { id: userId, name: 'Default User' };
  }
}

// Создание Circuit Breaker
const breaker = new CircuitBreaker(fetchExternalData, {
  timeout: 3000,          // Таймаут операции
  errorThresholdPercentage: 50, // % ошибок для размыкания
  resetTimeout: 30000     // Время до попытки восстановления
});

// Использование
breaker.fire(123)
  .then(data => console.log('Success:', data))
  .catch(err => console.error('Breaker open or error:', err));

В этом примере axios обрабатывает таймауты на уровне запроса, а opossum реализует паттерн Circuit Breaker, оборачивая нашу функцию вызова. Fallback реализован внутри функции в блоке catch.

Где это применяется

Эти подходы критически важны в микросервисной архитектуре, где сервисы активно общаются между собой, а также в любых приложениях, зависящих от сторонних API (платежные шлюзы, сервисы геолокации, отправка email/SMS). Они повышают общую доступность (availability) и отзывчивость системы.

Вывод: Применяйте комбинацию таймаутов, повторных попыток, Circuit Breaker и fallback-логики, когда ваш сервис зависит от внешних API, особенно если их отказ не должен полностью блокировать работу вашего приложения. Это фундамент для создания отказоустойчивых и resilient-систем.