待機室を作成する

ダッシュボードまたはAPIを介して待機室を作成できます。

待機室の作成に関する追加のコンテキストについては、始めるを参照してください。

ダッシュボード

1. アプリケーション内で、トラフィック > 待機室に移動します。
2. 作成を選択します。
3. 待機室の設定をカスタマイズします。追加のガイダンスについては、ベストプラクティスを参照してください。
4. 次へを選択します。
5. 待機室をカスタマイズしたい場合、必要に応じてHTMLとCSSを更新します。この待機室をモバイルアプリやAPIのトラフィック管理に使用する場合は、JSONレスポンストグルを有効にします。クライアント（モバイルまたはWebアプリ）用にJSONフレンドリーなレスポンスを設定していることを確認してください。
6. ユーザーが待機室にいるときに返されるHTTPステータスコードを決定するために、キューイングステータスコードを選択します。
7. 次へを選択します。
8. 保存する前に設定を確認します。待機室をカスタマイズした場合は、結果をプレビューしてください。
9. 保存を選択します。新しい待機室はデフォルトで有効になります。

API

APIを使用して待機室を作成するには、/zones/{zone_identifier}/waiting_roomsエンドポイントにPOSTリクエストを送信します：

• パラメータの参照については、設定を参照してください。
• 認証手順については、APIトークンの作成を参照してください。
• エンドポイントとページネーションに関するヘルプについては、API呼び出しを行うを参照してください。

リクエスト

curl -X POST "https://api.cloudflare.com/client/v4/zones/{zone_identifier}/waiting_rooms" \
--header 'Authorization: Bearer REDACTED' \
--header 'Content-Type: application/json' \
--data '{
  "name": "shop_waiting_room",
  "description": "ウェブショップの待機室",
  "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"
  }
}'

レスポンスには、新しく作成された待機室の完全な定義が含まれています。

レスポンス

{
  "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": "ウェブショップの待機室",
      "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"
      }
    }
  ]
}