curl --request POST \
--url 'https://management.scanova.io/folder/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Holiday Campaign",
"color": "#22C55E"
}'
{
"id": 42,
"name": "Holiday Campaign",
"color": "#22C55E",
"created_by": 1029,
"folder_type": "qr",
"qr_codes_count": 0,
"created": "2026-08-16T20:40:02.115000+05:30",
"updated": "2026-08-16T20:40:02.115000+05:30"
}
管理 API — 文件夹与标签
创建文件夹
POST /folder/
POST
/
folder
/
curl --request POST \
--url 'https://management.scanova.io/folder/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Holiday Campaign",
"color": "#22C55E"
}'
{
"id": 42,
"name": "Holiday Campaign",
"color": "#22C55E",
"created_by": 1029,
"folder_type": "qr",
"qr_codes_count": 0,
"created": "2026-08-16T20:40:02.115000+05:30",
"updated": "2026-08-16T20:40:02.115000+05:30"
}
文件夹用于对二维码进行归类整理——与仪表盘 QR Codes > Folders 侧边栏中展示的文件夹相同。使用此端点可以列出账户的文件夹，或从您自己的系统中创建新文件夹。
两个操作都需要一个拥有
MANAGEMENT_API（或 MANAGEMENT_API_SANDBOX）配额的 Management API 密钥，以原始 Authorization 请求头的值发送。身份验证细节请参见 Management API 概览。curl --request POST \
--url 'https://management.scanova.io/folder/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"name": "Holiday Campaign",
"color": "#22C55E"
}'
{
"id": 42,
"name": "Holiday Campaign",
"color": "#22C55E",
"created_by": 1029,
"folder_type": "qr",
"qr_codes_count": 0,
"created": "2026-08-16T20:40:02.115000+05:30",
"updated": "2026-08-16T20:40:02.115000+05:30"
}
string
必填
文件夹名称，最多 150 个字符。在给定的
folder_type 内，该名称在此账户中必须唯一——重复的名称会返回一个 400 错误，内容为 {"name": ["Folder name already exists."]}。string
十六进制颜色值，例如
#4F6BF4。string
默认值:"qr"
qr 或 page。创建文件夹需要账户的
FOLDER_MANAGEMENT 配额（文件夹管理在部分套餐中属于付费能力）——返回 403 并附带 "Your plan does not have folder management quota." 消息，说明该套餐不包含此功能。列出文件夹则没有此项限制。相关内容
- 列出文件夹 — 同一端点的另一个操作。
- 标签管理 —— 另一种二维码归类整理机制，可与文件夹配合（或替代文件夹）使用。
- 列出 / 创建二维码 —— 通过此处返回的文件夹 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: 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.
响应
201
Folder created
此页面对您有帮助吗？
⌘I