Кэш ответов REST API: заголовок X-Cache и цена повтора

Часть сервисов кэширует ответы там, где данные это допускают: Wordstat и Keywords, Smart Scrape, Lighthouse, проверка SSL и реестра РКН. Кэш общий: повторный такой же запрос в пределах окна кэша оплачивается по цене кэша (окна и цены — в таблице цен). Поиск, Tavily Extract, IP-геолокация и GET /v1/me кэш ответов не проходят: заголовка X-Cache у них нет.

Заголовок X-Cache

Значение	Что означает
HIT	ответ отдан из кэша, по цене кэша
MISS	в кэше не было — запрос выполнен заново
BYPASS	вы прислали Cache-Control: no-cache: кэш не читали, запрос оплачен полностью, свежий ответ записан в кэш
DISABLED	эндпоинт проходит через кэш, но кэширование для него выключено
UNPRICED	запрос выполнен и не тарифицирован — для эндпоинта нет строки в прайсе
UNCACHEABLE	запрос нельзя однозначно идентифицировать — он выполняется и оплачивается полностью, но в кэш не попадает

Чтобы получить свежий ответ, передайте Cache-Control: no-cache; следующий обычный запрос получит уже его.

UNCACHEABLE стоит проверить у себя: так помечаются запросы с некорректной query-строкой (например, с разделителем ; вместо &), с оборванным телом или с телом больше допустимого.