curl --request GET \
--url 'https://api.scanova.io/folder/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"id": 41,
"name": "Product Launch",
"color": "#4F6BF4",
"created_by": 1029,
"folder_type": "qr",
"qr_codes_count": 12,
"created": "2026-07-01T09:12:04.221000+05:30",
"updated": "2026-07-14T16:03:11.884000+05:30"
},
{
"id": 40,
"name": "Retail Campaign",
"color": null,
"created_by": 1029,
"folder_type": "qr",
"qr_codes_count": 0,
"created": "2026-06-18T11:45:32.009000+05:30",
"updated": "2026-06-18T11:45:32.009000+05:30"
}
]
}
文件夹与标签
列出文件夹
GET /folder/
GET
/
folder
/
curl --request GET \
--url 'https://api.scanova.io/folder/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"id": 41,
"name": "Product Launch",
"color": "#4F6BF4",
"created_by": 1029,
"folder_type": "qr",
"qr_codes_count": 12,
"created": "2026-07-01T09:12:04.221000+05:30",
"updated": "2026-07-14T16:03:11.884000+05:30"
},
{
"id": 40,
"name": "Retail Campaign",
"color": null,
"created_by": 1029,
"folder_type": "qr",
"qr_codes_count": 0,
"created": "2026-06-18T11:45:32.009000+05:30",
"updated": "2026-06-18T11:45:32.009000+05:30"
}
]
}
文件夹用于对二维码进行归类整理——与仪表盘 QR Codes > Folders 侧边栏中展示的文件夹相同。使用此端点可以列出账户的文件夹，或从您自己的系统中创建新文件夹。
结果按分页返回（默认每页 10 条，通过
两个操作都需要一个拥有
MANAGEMENT_API（或 MANAGEMENT_API_SANDBOX）配额的 Management API 密钥，以原始 Authorization 请求头的值发送。身份验证细节请参见 Management API 概览。curl --request GET \
--url 'https://api.scanova.io/folder/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"id": 41,
"name": "Product Launch",
"color": "#4F6BF4",
"created_by": 1029,
"folder_type": "qr",
"qr_codes_count": 12,
"created": "2026-07-01T09:12:04.221000+05:30",
"updated": "2026-07-14T16:03:11.884000+05:30"
},
{
"id": 40,
"name": "Retail Campaign",
"color": null,
"created_by": 1029,
"folder_type": "qr",
"qr_codes_count": 0,
"created": "2026-06-18T11:45:32.009000+05:30",
"updated": "2026-06-18T11:45:32.009000+05:30"
}
]
}
page_size 最多可设为 100 条），并按最新创建排序。
integer
要获取的页码。
integer
默认值:"10"
每页返回的文件夹数量，最大为 100。
string
筛选为
qr（标准二维码文件夹）或 page（限定于页面构建器页面的文件夹）。string
对文件夹名称进行不区分大小写的子字符串匹配。
响应字段
integer
文件夹 ID——按文件夹筛选二维码分析数据时作为
folder 值传入，或在仪表盘中将二维码移动到该文件夹时使用。string
文件夹名称。在同一账户内、同一
folder_type 下唯一。string | null
在侧边栏中文件夹旁显示的十六进制颜色值（例如
#4F6BF4），未设置时为 null。integer | null
创建该文件夹的用户 ID——如果该用户后来已从账户中移除，则为
null。string
qr 或 page。integer
当前分配到此文件夹的二维码数量。
string
ISO 8601 格式的创建时间戳。
string
ISO 8601 格式的最后更新时间戳。
相关内容
- 创建文件夹 — 同一端点的另一个操作。
- 标签管理 —— 另一种二维码归类整理机制，可与文件夹配合（或替代文件夹）使用。
- 列出 / 创建二维码 —— 通过此处返回的文件夹 ID，以
?folder=筛选二维码。 - Management API 概览 —— 本端点所属的身份验证方案与配额架构。
授权
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: YOUR_API_KEY. 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. api.scanova.io) — the same key sent to the regular API host will not authenticate.
响应
200
List of folders
此页面对您有帮助吗？