← Cloudflare Waiting Room / waiting-room / how-to

Vytvoření čekárny

Čekárnu můžete vytvořit v dashboardu nebo prostřednictvím API.

Ve své aplikaci přejděte na Provoz > Waiting Room.
Vyberte Vytvořit.
Přizpůsobte nastavení pro vaši čekárnu. Další pokyny najdete v Osvědčené postupy.
Vyberte Next.
V této části můžete zvolit, zda povolit Turnstile pro vaši čekárnu. Pokud vyberete Ano, budete muset zvolit své Režim widgetu a určete akci, která se provede, pokud Turnstile challenge selže. Dostupné режimy widgetu a akce závisí na typu vašeho plánu. Další informace najdete v Plány pro další podrobnosti.
Pokud chcete přizpůsobit čekárnu, podle potřeby upravte HTML a CSS. Pokud tuto čekárnu používáte ke správě provozu pro svou mobilní aplikaci nebo rozhraní API, zapněte přepínač odpovědi JSON. Ujistěte se, že máte nastavené Odpověď kompatibilní s JSON pro vašeho klienta (mobilní nebo webovou aplikaci).
Vyberte Stavový kód řazení do fronty k určení stavového kódu HTTP, který se vrátí, když je uživatel v čekárně.
Vyberte Next.
Před uložením zkontrolujte svá nastavení. Pokud jste si waiting room upravili, nezapomeňte náhled výsledku.
Vyberte Save. Vaše nová čekárna bude ve výchozím nastavení povolena.

Chcete-li vytvořit Waiting Room pomocí API, odešlete POST požadavek do /zones/{zone_identifier}/waiting_rooms koncový bod:

Odkazy na parametry najdete v Nastavení konfigurace
Pokyny k ověřování najdete v Vytvořte token API.
Nápovědu ke koncovým bodům a stránkování najdete v Volání API.

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

Alespoň jeden z následujících oprávnění tokenu je povinné:

Waiting Rooms Write

Vytvoření čekárny

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

Odpověď obsahuje kompletní definici nově vytvořeného Waiting Room.

Odpověď

{
	"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"
			}
		}
	]
}