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

# App Store QR Code

> 创建一个链接到您应用在 App Store 或 Play Store 页面的 QR 码。

## 适用场景

App Store QR 码会将扫描者直接引导至您应用在 Google Play 或 Apple App Store 中的页面——并根据扫描设备自动选择正确的商店。它是一种 **Quick Code**——一种没有落地页的直接动作型 QR。在应用中，其卡片上的文案是 "Send scanners to the right app store for their device."（将扫描者引导至适合其设备的应用商店）。

<Note>
  App Store **始终是动态（dynamic）** QR 码——这是实现扫描时基于操作系统自动跳转所必需的。您会获得一个 Scanova 短链接（`scnv.io/...`），也可以绑定自定义域名，但它本身没有落地页。
</Note>

## 跳转行为

在 **Auto-detect device and redirect** 开启（默认状态）的情况下，扫描行为如下：

* **Android** 设备会被直接跳转到 Google Play 网址。
* **iOS 或 Mac** 设备会被直接跳转到 Apple App Store 网址。
* 其他任何设备都会看到一个列出两个链接的选择界面。

将该开关**关闭**后，无论设备类型如何，所有扫描者始终会看到列出两个链接的选择界面。

<Tip>
  如果您只填写了一个商店网址，那么无论设备类型如何，扫描者都只会看到这一个链接。
</Tip>

## 创建一个 App Store QR 码

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

  <Step title="选择 App Store">
    在 **Quick Code** 类型网格中，点击顶部 **Dynamic** 分区下 **App Store** 下方的 **Configure**（此类型没有 Static 选项）。这会打开 `/qr/quick/appStore` 处的表单。
  </Step>

  <Step title="添加您的商店链接">
    输入您的 **Google Play Store URL** 和/或 **Apple App Store URL**——至少添加一个。除非您明确希望无论设备类型如何，所有扫描者都看到选择界面，否则请保持 **Auto-detect device and redirect** 开启。

    <Frame caption="已填写两个商店网址且自动检测已开启的 App Store Quick Code 表单">
      <img src="https://mintcdn.com/scanova-api/q8t3kzcRTgAP7jV0/images/v2/qr-codes/create/app-store/app-store-quick-code-form.png?fit=max&auto=format&n=q8t3kzcRTgAP7jV0&q=85&s=eae5c160fac9ce8f6818cc4d82fcaaae" alt="App Store Quick Code 表单，已填写 Google Play 和 Apple App Store 网址，自动检测开关已开启，以及该动态 QR 码自动生成的短链接" width="1280" height="976" data-path="images/v2/qr-codes/create/app-store/app-store-quick-code-form.png" />
    </Frame>
  </Step>

  <Step title="查看短链接">
    由于此类型始终是动态的，系统会自动生成一个 Scanova 短链接（例如 `scnv.io/6z02`）。您可以在 **Advanced settings** 下编辑该 slug、绑定已验证的自定义域名，或启用 UTM 追踪参数。
  </Step>

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

## 通过 API 创建

若要通过 API 而非界面创建 App Store QR 码，请使用类别 ID `10`（在 [Create QR Code](/v1/api-reference/endpoint/qr_manager/create) 的 **Category dropdown reference** 表中标记为 **App Store**，`allowed_qr_types: "dy"`——`qr_type` 只能取 `"dy"`），其 `info` 负载结构如下：

```json theme={null}
{
  "type": "appStore",
  "data": [
    { "type": "playStore", "url": "https://play.google.com/store/apps/details?id=com.acme.app" },
    { "type": "appleStore", "url": "https://apps.apple.com/app/id123456789" }
  ]
}
```

`data` 是一个包含 0–2 项（`playStore` 和/或 `appleStore`）的数组——至少包含一项。一个可选的同级字段 `settings: { "autoDetectDisabled": true }` 可禁用自动跳转、始终展示选择界面；省略该字段（或将其设为 `false`）则保持自动检测开启。

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

## 相关内容

* [App Deep Link QR Code](/zh/qr-codes/create/app-deep-link) —— 直接打开应用中的特定界面，而不是商店页面。
* [创建您的第一个 QR 码](/zh/getting-started/first-qr-code) —— 完整介绍此类型所属的 Quick Code 流程。
* [文件夹、标签与批量操作](/zh/qr-codes/manage/folders-tags-bulk-operations) —— 发布后整理该 QR 码。