INTEGRITY Dokumentace

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

Vytváření a správa widgetů pomocí Cloudflare API

Použijte Cloudflare API pro programovou správu widgetů a automatizaci.

Předpoklady

Než začnete, budete potřebovat:

Vytvoření widgetu přes API

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

Alespoň jedno z následujících oprávnění tokenu je povinný:
Vytvoření widgetu 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"
	}'

Správa widgetů přes API

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

Alespoň jedno z následujících oprávnění tokenu je povinný:
Výpis widgetů Turnstile
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/challenges/widgets" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

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

Alespoň jedno z následujících oprávnění tokenu je povinný:
Podrobnosti widgetu Turnstile
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/challenges/widgets/$SITEKEY" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

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

Alespoň jedno z následujících oprávnění tokenu je povinný:
Aktualizace widgetu 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"
	}'

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

Alespoň jedno z následujících oprávnění tokenu je povinný:
Rotate Secret for a Turnstile Widget
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
	}'

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

Alespoň jedno z následujících oprávnění tokenu je povinný:
Odstranění widgetu Turnstile
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/challenges/widgets/$SITEKEY" \
	--request DELETE \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"