Отметим: когда API возвращает 200 с полным телом на каждый запрос, это бесполезно тратит трафик и нагружает сервер. Мы настраиваем HTTP-кэширование так, чтобы клиенты и CDN кэшировали ответы, а сервер отвечал 304 Not Modified, если данные не изменились. За 7 лет мы внедрили эту стратегию в 50+ проектах — снижали трафик до 90% и ускоряли средний ответ на 50%. Это позволяет сократить расходы на инфраструктуру до 70%. Типичная экономия на инфраструктуре для проектов с 10 000+ запросов в час составляет от 100 000 рублей в месяц.
Проблемы, которые решаем
Проблема 1: Отсутствие ETag — клиент не может сделать условный запрос. Каждый запрос возвращает полное тело, даже если данные не менялись. Решение: вычисляем хеш по updated_at и id (для единичных ресурсов) или по максимальному updated_at + количество записей (для коллекций). ETag точнее Last-Modified, так как реагирует на любые изменения, а не только на время.
Проблема 2: Неправильный Vary — CDN кэширует ответ для одного языка или сжатия и отдаёт всем. Например, если Vary не содержит Accept-Language, русский пользователь может получить английскую версию. Решение: указываем все заголовки, влияющие на представление.
Проблема 3: «Мёртвый» Cache-Control — no-cache без ETag — клиент не кэширует вообще. Оптимальная комбинация: Cache-Control: public, max-age=60, s-maxage=300 + ETag.
Как мы это делаем: стек и кейс
Используем Laravel 11 на PHP 8.3, PostgreSQL, Redis. Для каждого эндпоинта API определяем стратегию кэширования:
- Единичные ресурсы — ETag на основе
updated_at+id. ЕслиIf-None-Matchсовпадает — 304. - Коллекции — ETag по максимальному
updated_atи количеству записей с учётом пагинации. - Мультиязычные —
Vary: Accept-Language, ETag включает код языка.
Пример из реального проекта: каталог товаров с 50 000 позиций, 10 языков. После настройки ETag + Vary трафик на CDN снизился с 200 ГБ/мес до 30 ГБ/мес (на 85%), а среднее время ответа упало с 800 мс до 150 мс для кэшированных запросов. Средняя экономия на CDN-трафике составила 120 000 рублей в месяц. Если хотите получить аналогичный результат, закажите аудит кэширования вашего API.
Почему ETag эффективнее Last-Modified?
Last-Modified имеет точность до секунды — если обновления происходят чаще, возможны коллизии. ETag учитывает само содержимое, поэтому детектирует любые изменения, включая перезапись тех же данных (если хеш считается по содержимому). Для JSON API мы используем хеш от updated_at и id — он дёшев и достаточно уникален.
| Характеристика | ETag | Last-Modified |
|---|---|---|
| Точность | Все изменения | Секундная гранулярность |
| Вычисление | Хеш данных | Временная метка |
| Коллизии | Нет при хорошем хеше | Возможны при частых обновлениях |
| Рекомендация | JSON API | Статические файлы |
Настройка Vary для мультиязычного API
Укажите в ответе Vary: Accept-Language, Accept-Encoding. Для CORS с разными origin — Origin. Избегайте Vary: Authorization — каждый токен создаёт отдельную запись в кэше CDN. Если нужна авторизация, используйте приватное кэширование (private, max-age=0, must-revalidate) и ETag.
Как инвалидировать кэш на CDN?
Используйте теги (Cache-Tag) или суррогатные ключи. При обновлении ресурса отправляете запрос на purge по тегу. Cloudflare и Fastly поддерживают массовую инвалидацию одним вызовом API. Экономия на CDN-трафике может достигать 90%, что снижает затраты на хостинг.
Директивы Cache-Control
| Директива | Назначение | Пример |
|---|---|---|
| no-cache | Требовать свежесть | no-cache |
| no-store | Запрет кэша | Конфиденциальные данные |
| public | Разрешить CDN | Публичный API |
| private | Только клиент | Личный кабинет |
| max-age | Время жизни кэша клиента | max-age=60 |
| s-maxage | Время жизни кэша CDN | s-maxage=300 |
Пример middleware для Laravel
public function handle($request, Closure $next) { $response = $next($request); if ($response->isSuccessful()) { $etag = md5($response->getContent()); $response->setEtag($etag); $response->setLastModified($response->getDate()); if ($response->isNotModified($request)) { return response()->noContent(304); } } return $response; } Процесс работы
- Аналитика — аудит текущих заголовков, выявление узких мест.
- Проектирование — выбор стратегии для каждого эндпоинта (сильное/условное кэширование).
- Реализация — добавление ETag, Last-Modified, Vary в middleware или контроллеры.
- Тестирование — проверка кодов ответа, заголовков, поведения CDN.
- Деплой — настройка инвалидации (суррогатные ключи, purge API).
Сроки ориентировочно
| Этап | Срок |
|---|---|
| Базовое кэширование (ETag + Last-Modified) | 2–4 дня |
| Полная стратегия (Vary, Cache-Control, инвалидация) | 1–2 недели |
Стоимость рассчитывается индивидуально после анализа вашего API.
Что входит в работу
- Реализация ETag / Last-Modified для всех эндпоинтов
- Настройка Cache-Control и Vary по типам ресурсов
- Интеграция с CDN (Cloudflare, Fastly)
- Система инвалидации кэша (суррогатные ключи или purge API)
- Документация по стратегии кэширования
- Пост-релизная поддержка в течение 2 недель
Итог
Правильное HTTP-кэширование — дешёвый способ радикально снизить нагрузку. Мы гарантируем, что после настройки вы увидите падение трафика и ускорение ответов. Получите консультацию по настройке кэширования вашего API — мы оценим текущую ситуацию и предложим оптимальную стратегию.
RFC 7232