Skip to main content
GET
المجلدات تجمّع رموز QR لتنظيمها — نفس المجلدات الظاهرة في الشريط الجانبي QR Codes > Folders في لوحة التحكم. استخدم نقطة النهاية هذه لسرد مجلدات الحساب أو إنشاء مجلد جديد من أنظمتك الخاصة.
كلتا العمليتين تتطلبان مفتاح Management API بحصة MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX)، يُرسل كقيمة خام لترويسة Authorization. راجع نظرة عامة على Management API لتفاصيل المصادقة.
النتائج مُرقّمة إلى صفحات (حجم الصفحة 10 افتراضيًا، حتى 100 عبر page_size) ومرتّبة من الأحدث إلى الأقدم.
integer
رقم الصفحة المطلوب جلبها.
integer
افتراضي:"10"
عدد المجلدات لكل صفحة. الحد الأقصى 100.
string
تصفية حسب qr (مجلدات رموز QR القياسية) أو page (مجلدات محصورة بصفحات منشئ الصفحات).
مطابقة جزء نصي غير حسّاسة لحالة الأحرف مقابل اسم المجلد.

حقول الاستجابة

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 لآخر تحديث.

ذات صلة

التفويضات

Authorization
string
header
مطلوب

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