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

# Simple Text QR Code

> 创建一个可显示纯文本的 QR 码。

## 适用场景

Simple Text QR 码会在扫描设备上显示纯文本——一段备注、一份配料清单、一个桌号、一句简短说明——无需联网即可显示。它是一种 **Quick Code**——一种没有落地页的直接动作型 QR。在应用中，其卡片上的文案是 "Show static text on scan — no internet needed."（扫描后显示静态文本——无需联网），页面本身标记为 **Plain Text**。

<Note>
  请勿将其与应用其他地方的 vCard/联系人风格的 "simple" QR（**Contact Card**，即 `simple-vcard` 类型）混淆。Simple Text 仅编码一段纯文本——没有联系人字段，也没有结构化数据。
</Note>

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

## 创建一个 Simple Text QR 码

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

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

  <Step title="输入文本内容">
    在 **Text content** 字段中输入要显示的文本——这是一个多行文本域，占位符为 "Type your message here…"。这是表单上唯一的字段，也是发布所必需的。

    <Frame caption="已输入文本的 Simple Text（Plain Text）Quick Code 表单">
      <img src="https://mintcdn.com/scanova-api/q8t3kzcRTgAP7jV0/images/v2/qr-codes/create/simple-text/simple-text-form-filled.png?fit=max&auto=format&n=q8t3kzcRTgAP7jV0&q=85&s=073b32bc2b8c3db7dc9109184258b0ca" alt="Plain Text Quick Code 表单，Text content 文本域中填写了一条简短消息，右侧带有实时 QR 预览" width="1440" height="900" data-path="images/v2/qr-codes/create/simple-text/simple-text-form-filled.png" />
    </Frame>
  </Step>

  <Step title="发布">
    点击 **Publish**。会弹出一个面板，用于确认或重命名 QR 码（无论您输入的内容是什么，默认都使用 "Plain Text"）、分配文件夹或标签，并在确认前调整 QR 码设计。
  </Step>
</Steps>

## 通过 API 创建

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

```json theme={null}
{
  "type": "text",
  "data": {
    "text": "Table 12 — thanks for dining with us!"
  }
}
```

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

<Note>
  [Category List](/v1/api-reference/references/category-list) 参考表目前尚未列出 Simple Text（以及本页其他仅限 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) —— Simple Text 与完整落地页相比处于什么位置。
* [文件夹、标签与批量操作](/zh/qr-codes/manage/folders-tags-bulk-operations) —— 发布后整理该 QR 码。