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"
}
Management-API — Ordner & Tags
Einen Ordner erstellen
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"
}
Ordner gruppieren QR-Codes zur Organisation — dieselben Ordner, die in der Seitenleiste QR-Codes > Ordner des Dashboards angezeigt werden. Verwenden Sie diesen Endpunkt, um die Ordner eines Kontos aufzulisten oder einen neuen aus Ihren eigenen Systemen heraus zu erstellen.
Beide Operationen erfordern einen Management-API-Schlüssel mit
MANAGEMENT_API- (oder MANAGEMENT_API_SANDBOX-)Quota, gesendet als roher Authorization-Header-Wert. Authentifizierungsdetails finden Sie in der Management-API-Übersicht.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
erforderlich
Ordnername, bis zu 150 Zeichen. Muss für dieses Konto innerhalb des angegebenen
folder_type eindeutig sein — ein Duplikat gibt einen 400-Fehler mit {"name": ["Folder name already exists."]} zurück.string
Hex-Farbwert, z. B.
#4F6BF4.string
Standard:"qr"
qr oder page.Das Erstellen eines Ordners erfordert die
FOLDER_MANAGEMENT-Quota des Kontos (Ordnerverwaltung ist auf manchen Plänen eine kostenpflichtige Funktion) — ein 403-Fehler mit "Your plan does not have folder management quota." bedeutet, dass der Plan diese Funktion nicht enthält. Das Auflisten von Ordnern unterliegt keiner solchen Sperre.Verwandte Themen
- Ordner auflisten — die andere Operation an diesem selben Endpunkt.
- Tag-Verwaltung — der andere QR-Organisationsmechanismus, verwendet neben (oder anstelle von) Ordnern.
- QR-Codes auflisten / erstellen — filtern Sie QR-Codes nach einer hier zurückgegebenen Ordner-ID über
?folder=. - Management-API-Übersicht — das Auth-Schema und die Quota-Architektur, zu der dieser Endpunkt gehört.
Autorisierungen
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.
Antwort
201
Folder created
War diese Seite hilfreich?
⌘I