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 de gestion — Dossiers et tags
Créer un dossier
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"
}
Les dossiers regroupent les QR codes à des fins d’organisation — les mêmes dossiers affichés dans la barre latérale QR Codes > Folders du tableau de bord. Utilisez cet endpoint pour lister les dossiers d’un compte ou en créer un nouveau depuis vos propres systèmes.
Les deux opérations nécessitent une clé Management API avec le quota
MANAGEMENT_API (ou MANAGEMENT_API_SANDBOX), envoyée comme valeur brute de l’en-tête Authorization. Voir la vue d’ensemble de la Management API pour les détails d’authentification.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
requis
Nom du dossier, jusqu’à 150 caractères. Doit être unique pour ce compte au sein du
folder_type donné — un doublon renvoie une erreur 400 avec {"name": ["Folder name already exists."]}.string
Couleur hexadécimale, par ex.
#4F6BF4.string
défaut:"qr"
qr ou page.Créer un dossier nécessite le quota
FOLDER_MANAGEMENT du compte (la gestion des dossiers est une fonctionnalité payante sur certains plans) — une erreur 403 avec « Your plan does not have folder management quota. » signifie que le plan ne l’inclut pas. Lister les dossiers n’a pas ce type de restriction.Voir aussi
- Lister les dossiers — l’autre opération de ce même endpoint.
- Gestion des tags — l’autre mécanisme d’organisation des QR codes, utilisé en complément (ou à la place) des dossiers.
- Lister / créer des QR codes — filtrez les QR codes par un ID de dossier renvoyé ici via
?folder=. - Vue d’ensemble de la Management API — le schéma d’authentification et l’architecture de quotas dont fait partie cet endpoint.
Autorisations
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.
Réponse
201
Folder created
Cette page vous a-t-elle été utile ?
⌘I