> ## 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.

# Email QR Code

> 创建一个可预填邮件内容的 QR 码。

## 适用场景

Email QR 码会打开设备的默认邮件应用，并预先填好收件人、主题和正文，因此扫描它就是发起一封邮件的一键式方式——无论是联系地址、支持邮箱，还是 RSVP 回复。它是一种 **Quick Code**——一种没有落地页的直接动作型 QR。在应用中，其卡片上的文案是 "Opens the mail app with subject and body pre-filled."（打开邮件应用，主题和正文已预填）。

<Note>
  Email **仅支持 Static**——此类型没有 Dynamic 选项。一旦发布，编码后的地址和消息将无法编辑或追踪；如需更改，请创建一个新的 QR 码。
</Note>

## 创建一个 Email QR 码

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

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

  <Step title="输入邮件详情">
    填写以下字段：

    * **To (email address)**（占位符 `hello@example.com`）—— 必填，会校验是否为有效的邮箱地址。
    * **Subject**（占位符 "Hi there!"）—— 可选。
    * **Body**（占位符 "Your message…"）—— 可选。

    <Frame caption="已填写收件人、主题和正文的 Email Quick Code 表单">
      <img src="https://mintcdn.com/scanova-api/q8t3kzcRTgAP7jV0/images/v2/qr-codes/create/email/email-quick-code-form.png?fit=max&auto=format&n=q8t3kzcRTgAP7jV0&q=85&s=8d829840ddbbc1080f8a9afd3f1fe1d9" alt="Email Quick Code 表单，To 字段填写了 sales@acme.com，带有主题和正文内容，右侧带有实时 QR 预览" width="1280" height="720" data-path="images/v2/qr-codes/create/email/email-quick-code-form.png" />
    </Frame>
  </Step>

  <Step title="发布">
    点击 **Publish**。会弹出一个面板，用于确认或重命名 QR 码（默认使用收件人地址）、分配文件夹或标签，并在确认前调整 QR 码设计。发布后，您可以在确认界面通过 **Edit Design** 重新访问设计（颜色、边框）。
  </Step>
</Steps>

## 通过 API 创建

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

```json theme={null}
{
  "type": "email",
  "data": {
    "to": "sales@acme.com",
    "subject": "Product inquiry",
    "body": "Hi, I'd like to learn more about your product."
  }
}
```

后端模式只要求 `to` 为必填项。该模式还接受 `cc` 和 `bcc` 字符串字段——仪表盘的 Email Quick Code 表单没有暴露这两个字段的输入框，但如果您直接通过 API 设置它们，两者都是有效的。

完整的请求结构请参见 [Create QR Code](/v1/api-reference/endpoint/qr_manager/create)。

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

## 相关内容

* [Text Message QR Code](/zh/qr-codes/create/text-message) —— 一种类似的直接动作型类型，预填的是短信而非邮件。
* [创建您的第一个 QR 码](/zh/getting-started/first-qr-code) —— 完整介绍此类型所属的 Quick Code 流程。
* [文件夹、标签与批量操作](/zh/qr-codes/manage/folders-tags-bulk-operations) —— 发布后整理该 QR 码。