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"
}
]
}
واجهة الإدارة — المجلدات والوسوم
سرد المجلدات
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"
}
]
}
المجلدات تجمّع رموز QR لتنظيمها — نفس المجلدات الظاهرة في الشريط الجانبي QR Codes > Folders في لوحة التحكم. استخدم نقطة النهاية هذه لسرد مجلدات الحساب أو إنشاء مجلد جديد من أنظمتك الخاصة.
النتائج مُرقّمة إلى صفحات (حجم الصفحة 10 افتراضيًا، حتى 100 عبر
كلتا العمليتين تتطلبان مفتاح Management API بحصة
MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX)، يُرسل كقيمة خام لترويسة Authorization. راجع نظرة عامة على Management API لتفاصيل المصادقة.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) ومرتّبة من الأحدث إلى الأقدم.
integer
رقم الصفحة المطلوب جلبها.
integer
افتراضي:"10"
عدد المجلدات لكل صفحة. الحد الأقصى 100.
string
تصفية حسب
qr (مجلدات رموز QR القياسية) أو page (مجلدات محصورة بصفحات منشئ الصفحات).string
مطابقة جزء نصي غير حسّاسة لحالة الأحرف مقابل اسم المجلد.
حقول الاستجابة
integer
معرّف المجلد — مرّر هذه القيمة كقيمة
folder عند تصفية تحليلات رموز QR حسب المجلد، أو عند نقل رموز QR إلى المجلد من لوحة التحكم.string
اسم المجلد. فريد لكل حساب ولكل
folder_type.string | null
لون سداسي عشري (مثل
#4F6BF4) يظهر بجانب المجلد في الشريط الجانبي، أو null إذا لم يُحدَّد.integer | null
معرّف المستخدم الذي أنشأ المجلد —
null إذا كان هذا المستخدم قد أُزيل منذ ذلك الحين من الحساب.string
qr أو page.integer
عدد رموز QR المُسندة حاليًا لهذا المجلد.
string
طابع زمني بصيغة ISO 8601 لتاريخ الإنشاء.
string
طابع زمني بصيغة ISO 8601 لآخر تحديث.
ذات صلة
- إنشاء مجلد — العملية الأخرى لنفس نقطة النهاية هذه.
- إدارة الوسوم — آلية تنظيم رموز QR الأخرى، تُستخدم جنبًا إلى جنب مع المجلدات (أو بدلًا منها).
- سرد / إنشاء رموز QR — صفِّ رموز QR حسب معرّف مجلد مُعاد هنا عبر
?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.
الاستجابة
200
List of folders
هل كانت هذه الصفحة مفيدة؟
⌘I