INTEGRITY Dokumentace

Early Hints pro SaaS

Early Hints umožňuje prohlížeči začít načítat zdroje ještě předtím, než origin server dokončí kompletní odpověď. Tím se zrychlí načítání stránky pro koncového uživatele. Jako poskytovatel SaaS můžete u některých vlastních názvů hostitelů upřednostnit rychlost. Pomocí vlastních metadat můžete zapněte Early Hints na jeden vlastní hostitelský název.


Předpoklady

Než budete moci využívat Early Hints for SaaS, musíte vytvořit vlastní hostitelský název. Přečtěte si Začínáme s Cloudflare for SaaS pokud jste tak ještě neučinili.


Zapnutí Early Hints pro jednotlivé vlastní hostname přes API

  1. Najděte ID své zóny, dostupné v dashboardu Cloudflare.

  2. Najděte svůj Authentication Key na API Tokens ↗ stránce v části Global API Key.

  3. Pokud jste vytváření nového vlastního hostitelského názvu, proveďte volání API podobné tomu v příkladu níže, přičemž uvedete "early_hints": "on":

Požadovaná oprávnění API tokenu

Alespoň jeden z následujících oprávnění tokenu je povinné:
Create Custom Hostname
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/custom_hostnames" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"hostname": "<CUSTOM_HOSTNAME>",
		"ssl": {
				"method": "http",
				"type": "dv",
				"settings": {
						"http2": "on",
						"min_tls_version": "1.2",
						"tls_1_3": "on",
						"early_hints": "on"
				},
				"bundle_method": "ubiquitous",
				"wildcard": false
		}
	}'
  1. U existujícího vlastního hostname vyhledejte id tohoto hostitelského názvu pomocí GET volání:

Požadovaná oprávnění API tokenu

Alespoň jeden z následujících oprávnění tokenu je povinné:
Vypsat vlastní hostitelské názvy
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/custom_hostnames?hostname=%7Bhostname%7D" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
  1. Poté proveďte volání API podle níže uvedeného příkladu se zadáním "early_hints": "on":

Požadovaná oprávnění API tokenu

Alespoň jeden z následujících oprávnění tokenu je povinné:
Edit Custom Hostname
curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/custom_hostnames/$CUSTOM_HOSTNAME_ID" \
	--request PATCH \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"ssl": {
				"method": "http",
				"type": "dv",
				"settings": {
						"http2": "on",
						"min_tls_version": "1.2",
						"tls_1_3": "on",
						"early_hints": "on"
				}
		}
	}'

V současnosti jsou všechny možnosti v settings jsou vyžadovány, aby se zabránilo nastavení těchto možností na výchozí hodnoty. Aktuální stav nastavení před aktualizací Early Hints můžete zjistit pomocí výstupu, který vrací id pro název hostitele.