← Images / images / optimization / hosted-images

Browser TTL

Browser TTL určuje, jak dlouho obrázek zůstane v mezipaměti prohlížeče, a konkrétně nastavuje cache-control hlavička odpovědi.

Ve výchozím nastavení je TTL obrázku nastaveno na dva dny, aby vyhovovalo potřebám uživatelů, například opětovnému nahrání obrázku pod stejným Custom ID.

Browser TTL můžete nastavit dvěma vlastními způsoby: na úrovni účtu, nebo u pojmenované varianty. Chcete-li určit, jak dlouho má prohlížeč uchovávat obrázek v mezipaměti, nastavte TTL v sekundách, podobně jako u max-age hlavička nastavena. Hodnota by měla být interval od jedné hodiny do jednoho roku.

Nastavení Browser TTL na úrovni účtu přepíše výchozí TTL.

curl --request PATCH 'https://api.cloudflare.com/client/v4/accounts/{account_id}/images/v1/config' \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Content-Type: application/json" \
--data '{
  "browser_ttl": 31536000
}'

Pokud je pro všechny obrázky nastavena hodnota Browser TTL na jeden rok, odpověď pro cache-control hlavička je v podstatě public, max-age=31536000, stale-while-revalidate=7200.

Nastavení Browser TTL pro pojmenovanou variantu je podrobnější možnost, která při vytváření nebo aktualizaci varianty obrázku přepíše vše výše uvedené, konkrétně browser_ttl v sekundách.

curl 'https://api.cloudflare.com/client/v4/accounts/<ACCOUNT_TAG>/images/v1/variants' \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Content-Type: application/json" \
--data '{
  "id":"avatar",
  "options": {
    "width":100,
    "browser_ttl": 86400
  }
}'

Pokud je pro obrázky vyžádané s touto variantou nastavena hodnota Browser TTL na jeden den, odpověď pro cache-control hlavička je v podstatě public, max-age=86400, stale-while-revalidate=7200.