Cloudflare и API-шлюз: где ломается кэш, авторизация и лимиты

Cloudflare и API-шлюз: где ломается кэш, авторизация и лимиты

Интеграция CDN с API-шлюзом часто выглядит простой только на схеме. На практике ошибки появляются в трёх местах: кэширование ответов, проброс заголовков и защита от перегрузки.

— Кэшируйте только идемпотентные методы и только при явном контроле ключа кэша. Для API опасно полагаться на стандартное поведение: один лишний заголовок в ключе — и кэш перестаёт быть предсказуемым.
— Не теряйте `Authorization`, `Cookie`, `X-Request-Id` и сервисные заголовки при проксировании. Иначе шлюз видит не тот контекст, а расследование инцидента превращается в ручной поиск.
— Разделяйте защиту на уровне edge и на уровне gateway. Cloudflare должен отсекать мусор и аномальный трафик раньше, чем запрос дойдёт до backend.

Отдельно проверьте лимиты. Если шлюз отвечает 429, Cloudflare не должен маскировать проблему агрессивным кэшем или ретраями без политики backoff. Иначе вы не снимаете нагрузку, а переносите её глубже в стек.

Для API лучшая схема — минимальный кэш, явные правила маршрутизации, строгая работа с заголовками и логирование на обеих сторонах. Стабильность инфраструктуры — залог масштабируемости.