Нужны ли таймауты ожидания ответа API?

Таймаут ожидания ответа API — это ограничение по времени, в течение которого клиент готов ждать ответ от сервера. Без него запрос может «зависнуть» на неопределённый срок: сервер перегружен, сеть потеряла пакеты, DNS не отвечает — а клиент всё ждёт. В результате исчерпываются потоки, соединения и память, и падает уже сам клиент.

Почему таймауты критичны

• Защита от «зависших» соединений: освобождаются ресурсы клиента.
• Быстрый отказ (fail fast): пользователь получает ошибку, а не бесконечный спиннер.
• Каскадная устойчивость: один медленный сервис не роняет всю систему.
• Предсказуемость SLA: время ответа ограничено сверху.

Виды таймаутов

Обычно различают connect timeout (установка TCP-соединения), read/socket timeout (ожидание данных после отправки запроса) и общий timeout на весь запрос. Настраивать стоит все три, иначе медленный handshake или медленная передача тела ответа всё равно подвесят клиент.

Пример на Node.js (axios)

const axios = require('axios');

const client = axios.create({
  baseURL: 'https://api.example.com',
  timeout: 3000, // общий таймаут 3 секунды
});

async function fetchUser(id) {
  try {
    const res = await client.get(`/users/${id}`);
    return res.data;
  } catch (e) {
    if (e.code === 'ECONNABORTED') {
      console.error('Превышен таймаут запроса');
    }
    throw e;
  }
}

Пример на Python (requests)

import requests

try:
    r = requests.get(
        'https://api.example.com/users/1',
        timeout=(2, 5)  # (connect, read) в секундах
    )
    data = r.json()
except requests.Timeout:
    print('Запрос не успел выполниться')

Как выбирать значение

1. Ориентируйтесь на p99 времени ответа сервиса, добавьте запас.
2. Таймаут клиента должен быть меньше таймаута вышестоящего вызова, чтобы ошибка всплывала корректно.
3. Для интерактивных запросов — секунды, для фоновых задач — десятки секунд.
4. Дополняйте таймауты ретраями с backoff, но осторожно, чтобы не усиливать нагрузку.

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