curl --request GET \
--url 'https://management.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"
}
]
}
API de gestion — Dossiers et tags
Lister les dossiers
GET /folder/
GET
/
folder
/
curl --request GET \
--url 'https://management.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"
}
]
}
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 résultats sont paginés (taille de page 10 par défaut, jusqu’à 100 via
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 GET \
--url 'https://management.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) et classés du plus récent au plus ancien.
integer
Numéro de page à récupérer.
integer
défaut:"10"
Nombre de dossiers par page. Maximum 100.
string
Filtrer sur
qr (dossiers de QR codes standards) ou page (dossiers limités aux pages du page builder).string
Correspondance de sous-chaîne insensible à la casse par rapport au nom du dossier.
Champs de réponse
integer
ID du dossier — à transmettre comme valeur
folder lors du filtrage des analyses de QR codes par dossier, ou lors du déplacement de QR codes dans le dossier depuis le tableau de bord.string
Nom du dossier. Unique par compte et par
folder_type.string | null
Couleur hexadécimale (par ex.
#4F6BF4) affichée à côté du dossier dans la barre latérale, ou null si non définie.integer | null
ID de l’utilisateur ayant créé le dossier —
null si cet utilisateur a depuis été retiré du compte.string
qr ou page.integer
Nombre de QR codes actuellement assignés à ce dossier.
string
Horodatage de création au format ISO 8601.
string
Horodatage ISO 8601 de la dernière mise à jour.
Voir aussi
- Créer un dossier — 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
200
List of folders
Cette page vous a-t-elle été utile ?
⌘I