Cloudflare API でウィジェットを作成・管理する

プログラムによるウィジェット管理と自動化には、Cloudflare API を使います。

前提条件

開始する前に、次が必要です。

Account:Turnstile:Edit 権限を持つ Cloudflare API トークン
Cloudflare ダッシュボードで確認できるアカウント ID

API でウィジェットを作成する

Required API token permissions

At least one of the following token permissions is required:

Turnstile Sites Write
Account Settings Write

Create a Turnstile Widgetbash

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 でウィジェットを管理する

Required API token permissions

At least one of the following token permissions is required:

Turnstile Sites Write
Turnstile Sites Read
Account Settings Write
Account Settings Read

List Turnstile Widgetsbash

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/challenges/widgets" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

Required API token permissions

At least one of the following token permissions is required:

Turnstile Sites Write
Turnstile Sites Read
Account Settings Write
Account Settings Read

Turnstile Widget Detailsbash

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/challenges/widgets/$SITEKEY" \
	--request GET \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

Required API token permissions

At least one of the following token permissions is required:

Turnstile Sites Write
Account Settings Write

Update a Turnstile Widgetbash

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

Required API token permissions

At least one of the following token permissions is required:

Turnstile Sites Write
Account Settings Write

Rotate Secret for a Turnstile Widgetbash

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

Required API token permissions

At least one of the following token permissions is required:

Turnstile Sites Write
Account Settings Write

Delete a Turnstile Widgetbash

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/challenges/widgets/$SITEKEY" \
	--request DELETE \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN"