Waiting Room を作成する

ダッシュボードまたは API から、Waiting Room を作成できます。

アプリケーション内で Traffic > Waiting Room を開きます。
Create を選びます。
Waiting Room の設定をカスタマイズします。追加の指針はベストプラクティスを参照してください。
Next を選びます。
このセクションでは、Waiting Room で Turnstile を有効にするかを選べます。Yes を選んだ場合は、Widget mode を選び、Turnstile チャレンジが失敗したときのアクションを定義します。利用できる Widget mode とアクションはプランによって異なります。詳細はプランを参照してください。
Waiting Room をカスタマイズする場合は、必要に応じて HTML と CSS を更新します。モバイルアプリや API のトラフィック管理にこの Waiting Room を使う場合は、JSON レスポンスのトグルを有効にします。クライアント（モバイルまたは Web アプリ）向けに JSON 対応のレスポンスを用意してください。
利用者が Waiting Room にいるときに返す HTTP ステータスコードを決めるため、Queuing status code を選びます。
Next を選びます。
保存前に設定を確認します。Waiting Room をカスタマイズした場合は、結果をプレビューしてください。
Save を選びます。新しい Waiting Room は、デフォルトで有効になります。

API で Waiting Room を作成するには、/zones/{zone_identifier}/waiting_rooms エンドポイントへ POST リクエストを送ります。

パラメーターのリファレンスは設定を参照してください
認証の手順は API トークンを作成するを参照してください
エンドポイントとページネーションは API を呼び出すを参照してください

Required API token permissions

At least one of the following token permissions is required:

Waiting Rooms Write

Create waiting roombash

curl "https://api.cloudflare.com/client/v4/zones/$ZONE_ID/waiting_rooms" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"name": "shop_waiting_room",
		"description": "Waiting room for webshop",
		"host": "shop.example.com",
		"path": "/shop",
		"queue_all": true,
		"new_users_per_minute": 200,
		"total_active_users": 300,
		"session_duration": 1,
		"disable_session_renewal": false,
		"json_response_enabled": false,
		"queueing_method": "fifo",
		"queueing_status_code": 202,
		"cookie_attributes": {
				"samesite": "auto",
				"secure": "auto"
		}
	}'

レスポンスには、新しく作成した Waiting Room の完全な定義が含まれます。

レスポンスjson

{
	"success": true,
	"errors": [],
	"messages": [],
	"result": [
		{
			"id": "1111111111111111111111",
			"created_on": "2023-01-01T05:20:00.12345Z",
			"modified_on": "2023-01-01T05:20:00.12345Z",
			"name": "shop_waiting_room",
			"description": "Waiting room for webshop",
			"host": "shop.example.com",
			"path": "/shop",
			"queue_all": true,
			"new_users_per_minute": 200,
			"total_active_users": 300,
			"session_duration": 1,
			"disable_session_renewal": false,
			"json_response_enabled": false,
			"queueing_method": "fifo",
			"queueing_status_code": 202,
			"cookie_attributes": {
				"samesite": "auto",
				"secure": "auto"
			}
		}
	]
}