← Cloudflare for Platforms / cloudflare-for-platforms / cloudflare-for-saas / performance

Early Hints for SaaS

Early Hints позволяет браузеру начать загрузку ресурсов ещё до того, как origin-сервер сформирует полный ответ. Это ускоряет загрузку страницы для конечного пользователя. Как поставщик SaaS вы можете отдавать приоритет скорости для некоторых своих пользовательских имён хоста. С помощью пользовательских метаданных вы можете включите Early Hints на одно пользовательское имя хоста.

Предварительные требования

Прежде чем использовать Early Hints for SaaS, нужно создать пользовательское имя хоста. См. Начало работы с Cloudflare for SaaS если вы ещё этого не сделали.

Включение Early Hints для отдельных пользовательских имён хостов через API

Найдите ID своей зоны, доступный в дашборде Cloudflare.
Найдите свой Authentication Key на API-токены ↗ странице в разделе Global API Key.
Если вы создание нового пользовательского имени хоста, выполните вызов API, аналогичный примеру ниже, указав "early_hints": "on":

Необходимые разрешения API-токена

Хотя бы одно из следующих права доступа токена требуется:

SSL and Certificates Write

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
		}
	}'

Для уже существующего пользовательского имени хоста найдите id этого имени хоста через GET вызов:

Необходимые разрешения API-токена

Хотя бы одно из следующих права доступа токена требуется:

SSL and Certificates Write
SSL and Certificates Read

Получить список пользовательских имён хостов

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/custom_hostnames?hostname=%7Bhostname%7D" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

Затем выполните вызов API, как показано в примере ниже, указав "early_hints": "on":

Необходимые разрешения API-токена

Хотя бы одно из следующих права доступа токена требуется:

SSL and Certificates Write

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"
				}
		}
	}'

В настоящее время все параметры в settings обязательны, чтобы эти параметры не задавались по умолчанию. Текущее состояние настроек перед обновлением Early Hints можно получить, используя ответ, который возвращает id для имени хоста.