INTEGRITY Документация

← Cloudflare Turnstile / turnstile / get-started / widget-management

Создание виджетов и управление ими через Cloudflare API

Используйте Cloudflare API для программного управления виджетами и автоматизации.

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

Перед началом работы вам понадобится:

Создание виджета через API

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

Хотя бы одно из следующих права доступа токена требуется:
Создание виджета Turnstile
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/challenges/widgets" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"domains": [
				"example.com"
		],
		"mode": "managed",
		"name": "My Example Turnstile Widget"
	}'

Управление виджетами через API

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

Хотя бы одно из следующих права доступа токена требуется:
Список виджетов Turnstile
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/challenges/widgets" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

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

Хотя бы одно из следующих права доступа токена требуется:
Сведения о виджете Turnstile
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/challenges/widgets/$SITEKEY" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

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

Хотя бы одно из следующих права доступа токена требуется:
Обновление виджета Turnstile
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/challenges/widgets/$SITEKEY" \
	--request PUT \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"domains": [
				"203.0.113.1",
				"cloudflare.com",
				"blog.example.com"
		],
		"mode": "invisible",
		"name": "blog.cloudflare.com login form",
		"clearance_level": "interactive"
	}'

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

Хотя бы одно из следующих права доступа токена требуется:
Ротация секрета для виджета Turnstile
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/challenges/widgets/$SITEKEY/rotate_secret" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"invalidate_immediately": false
	}'

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

Хотя бы одно из следующих права доступа токена требуется:
Удаление виджета Turnstile
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/challenges/widgets/$SITEKEY" \
	--request DELETE \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"