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

# 列出二维码

> GET /qr/

在 **Management API** 主机（`management.scanova.io`）上列出或创建二维码，使用您的原始 Management API 密钥进行身份验证——如果您还没有设置好密钥，请参见[概览](/zh/api-reference/management-api/overview)。

```
GET  https://management.scanova.io/qr/
POST https://management.scanova.io/qr/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
```

`GET /qr/` 返回该密钥所属账户拥有的二维码的分页、可筛选列表。

### 查询参数

<ParamField query="search" type="string">
  对二维码名称、`qrid`、动态 URL slug 以及文件夹名称进行自由文本搜索。
</ParamField>

<ParamField query="category" type="string">
  以逗号分隔的分类 slug，例如 `url,event`。匹配所列分类中的任意一个。
</ParamField>

<ParamField query="tags" type="string">
  以逗号分隔的标签名称。匹配所列标签中的任意一个。
</ParamField>

<ParamField query="type" type="string">
  以逗号分隔的二维码类型：`dy`（动态）、`st`（静态）。
</ParamField>

<ParamField query="folder" type="integer">
  文件夹 ID——仅返回该文件夹中的二维码。
</ParamField>

<ParamField query="created_from" type="string">
  ISO 日期。返回在此日期当天或之后创建的二维码。
</ParamField>

<ParamField query="created_till" type="string">
  ISO 日期。返回在此日期当天或之前创建的二维码。
</ParamField>

<ParamField query="ordering" type="string">
  以逗号分隔的一个或多个字段：`name`、`created`、`qr_type`、`category__name`。在字段前加 `-` 表示降序，例如 `ordering=-created`。
</ParamField>

<ParamField query="page" type="integer" default="1">
  页码。
</ParamField>

<ParamField query="page_size" type="integer" default="10">
  每页结果数，最大为 `100`。
</ParamField>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "count": 214,
    "next": 2,
    "previous": null,
    "results": [
      {
        "id": 88231,
        "qrid": "QR7K9M2XN",
        "name": "Product launch flyer",
        "qr_type": "dy",
        "qr_type_display": "Dynamic",
        "category": {
          "id": 1,
          "name": "Website URL",
          "slug": "url",
          "description": "Link a QR code straight to any website.",
          "preview_image": "https://cdn.scanova.io/categories/url.png",
          "allowed_qr_types": ["dy", "st"],
          "allowed_qr_types_display": ["Dynamic", "Static"],
          "is_active": true
        },
        "dynamic_url_object": {
          "url_hash": "a1b2c3",
          "complete_url": "https://qr.link/a1b2c3",
          "visit_count": 1042
        },
        "thumbnail": "https://cdn.scanova.io/thumbnails/QR7K9M2XN.png",
        "is_active": true,
        "folder": null,
        "created": "2026-06-02T14:03:11Z",
        "modified": "2026-08-10T08:41:02Z",
        "tags_list": ["campaign-2026", "print"],
        "is_password_protected": false,
        "is_age_restricted": false,
        "created_by": { "full_name": "Jordan Lee" },
        "published_at": "2026-06-02T14:05:00Z",
        "is_currently_draft": false
      }
    ]
  }
  ```
</ResponseExample>

<Warning>
  `next` 和 `previous` 是**页码**（或 `null`），而不是完整的 URL——本 API 的分页方式在这一点上与普通的 DRF `PageNumberPagination` 不同。请通过 `?page=2` 获取下一页，而不是跟随响应中的某个 URL。
</Warning>

<Note>
  `category` 是完整的分类对象——上方展示的字段只是具有代表性的一个子集；同一个对象还携带 `tags`、`is_new`、`has_landing_page`、`helpdesk_link`、`qr_name_pattern`、`created` 和 `modified`。`dynamic_url_object` 仅在动态（`dy`）二维码中才存在。
</Note>

## 相关内容

* [创建二维码](/zh/api-reference/management-api/qr/create) — 同一端点的另一个操作。
* [获取](/zh/api-reference/management-api/qr/retrieve) —— 对此列表中返回的单个二维码进行操作。
* [更新](/zh/api-reference/management-api/qr/update) —— 对此列表中返回的单个二维码进行操作。
* [删除](/zh/api-reference/management-api/qr/delete) —— 对此列表中返回的单个二维码进行操作。
* [下载二维码图片](/zh/api-reference/management-api/qr/download) —— 将这些二维码之一渲染为 PNG/SVG/PDF 等格式。
* [列出回收站中的二维码](/zh/api-reference/management-api/qr/trash) —— 从此列表中删除后二维码会去往何处。
* [Management API 概览](/zh/api-reference/management-api/overview) —— 适用于本端点的身份验证方案与配额规则。


## OpenAPI

````yaml api-reference/openapi/management-api.json GET /qr/
openapi: 3.1.0
info:
  title: Scanova Management API (v2)
  description: >-
    The complete Scanova Management API — every endpoint available at
    management.scanova.io (QR codes, folders, tags, leads, forms, analytics,
    plans, shared users & roles), plus the token-creation and usage-stats
    endpoints used to authenticate against it. Every path and request/response
    shape below was verified live against a real API key and the actual running
    backend (Phase 7, 2026-08-16) — not guessed from reading urls.py alone.
  version: 2.0.0
servers:
  - url: https://management.scanova.io
    description: Management API — QR/folder/tag/lead/form/analytics/plans endpoints
security:
  - apiKeyAuth: []
paths:
  /qr/:
    get:
      summary: List QR codes
      operationId: listManagedQrCodes
      responses:
        '200':
          description: List of QR codes
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Send your Management API key as the raw value of the Authorization
        header — no "Bearer " or "Token " prefix, and no other characters.
        Example: `Authorization: 401f7ac837da42b97f613d789819ff93537bee6a`. A
        header containing more than one space-separated part is rejected
        outright. Requests also require the request's Host header to be the
        management API host (e.g. management.scanova.io) — the same key sent to
        the regular API host will not authenticate.

````