> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# WiFi QR Code

> 创建一个可让访客连接 WiFi 网络的 QR 码。

## 适用场景

Wi-Fi QR 码让手机摄像头自动加入无线网络——无需手动输入 SSID 或密码。它是一种 **Quick Code**：一种没有落地页的直接动作型 QR，由一个小表单构建而成，而不是 Page Builder。应用中它的卡片文案是 "Connect visitors to your Wi-Fi network instantly."（让访客瞬间连接到您的 Wi-Fi 网络）。

<Note>
  Wi-Fi **仅支持 Static**——此类型没有 Dynamic 选项。一旦发布，编码后的网络凭据将无法编辑或追踪；如需更改，请创建一个新的 QR 码。
</Note>

## 创建一个 Wi-Fi QR 码

<Steps>
  <Step title="打开 Create QR Code 并选择 Quick Code">
    在侧边栏中，进入 **QR Codes**，然后点击 **Create QR Code**（或前往 `/qr/create`）。点击 **Quick Code** 卡片。
  </Step>

  <Step title="选择 Wi-Fi">
    在 **Quick Code** 类型网格中，点击 **Static Only** 分区下 **Wi-Fi** 下方的 **Configure**。这会打开 `/qr/quick/wifi` 处的表单。
  </Step>

  <Step title="输入网络名称">
    在 **Network name (SSID)** 中输入网络的 SSID——这是唯一的必填字段。占位符显示 "My Network"。
  </Step>

  <Step title="选择安全类型">
    **Security type** 下拉菜单默认选中 **WPA2**，同时也提供 **WPA**、**WEP** 和 **None (open network)** 选项。选择 **None** 会完全隐藏 **Password** 字段，因为开放网络没有密码需要编码。

    <Frame caption="展开的 Security type 下拉菜单，展示 WPA2、WPA、WEP 和 None (open network)">
      <img src="https://mintcdn.com/scanova-api/q8t3kzcRTgAP7jV0/images/v2/qr-codes/create/wifi/wifi-security-type-options.png?fit=max&auto=format&n=q8t3kzcRTgAP7jV0&q=85&s=995eab4913263489cad6fa0b213c098b" alt="Wi-Fi Quick Code 表单，Security type 下拉菜单展开，展示 WPA2（已选中）、WPA、WEP 和 None (open network) 选项" width="1440" height="900" data-path="images/v2/qr-codes/create/wifi/wifi-security-type-options.png" />
    </Frame>
  </Step>

  <Step title="输入密码和隐藏网络设置">
    对于除 None 之外的任何安全类型，请在 **Password** 字段中输入网络密码。如果该网络不广播其 SSID，请打开 **Hidden network (SSID is not broadcast)**，以便扫描设备知道需要通过名称加入网络，而不是从可见列表中选择。

    <Frame caption="已填写完成的 Wi-Fi Quick Code 表单，带有实时 QR 预览，Publish 已启用">
      <img src="https://mintcdn.com/scanova-api/q8t3kzcRTgAP7jV0/images/v2/qr-codes/create/wifi/wifi-form-filled.png?fit=max&auto=format&n=q8t3kzcRTgAP7jV0&q=85&s=3f24aee10f5c456b2424ca005a887477" alt="Wi-Fi Quick Code 表单，已填写网络名称 docs-v2-Guest-WiFi、WPA2 安全类型、一个密码，Hidden network 开关已开启——已出现 QR 预览，Publish 按钮现已启用" width="1440" height="900" data-path="images/v2/qr-codes/create/wifi/wifi-form-filled.png" />
    </Frame>
  </Step>

  <Step title="发布">
    点击 **Publish**。会弹出一个面板，用于确认或重命名 QR 码（默认使用 "Wi-Fi: \<network name>"）、分配文件夹或标签，并在确认前调整 QR 码设计。
  </Step>
</Steps>

## 通过 API 创建

若要通过 API 而非界面创建 Wi-Fi QR 码，请使用类别 ID `6`（标记为 **WiFi**，`allowed_qr_types: "st"`——`qr_type` 只能取 `"st"`），其 `info` 负载结构如下：

```json theme={null}
{
  "type": "wifi",
  "data": {
    "authentication": "WPA2",
    "ssid": "Guest-WiFi",
    "password": "SampleGuestPass123",
    "hidden": false
  }
}
```

`authentication` 接受 `WPA`、`WPA2`、`WEP` 或 `none`；`password` 和 `hidden` 均为可选字段（`hidden` 默认值为 `false`）。完整的请求结构请参见 [Create QR Code](/v1/api-reference/endpoint/qr_manager/create)。

<Note>
  [Category List](/v1/api-reference/references/category-list) 参考表目前尚未列出 WiFi（以及本页其他仅限 Quick Code 的类别）——上述 ID 是直接对照实际的 `/qr/category/` 端点确认得到的。
</Note>

## 相关内容

* [创建您的第一个 QR 码](/zh/getting-started/first-qr-code) —— 完整介绍此类型所属的 Quick Code 流程。
* [Quick Code 与完整 Page 的对比](/zh/qr-codes/create/quick-code-vs-page) —— Wi-Fi 及其他 Quick Code 类型与完整落地页相比处于什么位置。
* [文件夹、标签与批量操作](/zh/qr-codes/manage/folders-tags-bulk-operations) —— 发布后整理该 QR 码。