إنشاء مجلد

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"
}

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"
}

المجلدات تجمّع رموز QR لتنظيمها — نفس المجلدات الظاهرة في الشريط الجانبي QR Codes > Folders في لوحة التحكم. استخدم نقطة النهاية هذه لسرد مجلدات الحساب أو إنشاء مجلد جديد من أنظمتك الخاصة.

كلتا العمليتين تتطلبان مفتاح Management API بحصة MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX)، يُرسل كقيمة خام لترويسة Authorization. راجع نظرة عامة على Management API لتفاصيل المصادقة.

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

مطلوب

اسم المجلد، حتى 150 حرفًا. يجب أن يكون فريدًا لهذا الحساب ضمن folder_type المحدد — التكرار يعيد 400 مع {"name": ["Folder name already exists."]}.

string

لون سداسي عشري، مثل #4F6BF4.

string

افتراضي:"qr"

qr أو page.

إنشاء مجلد يتطلب حصة FOLDER_MANAGEMENT الخاصة بالحساب (إدارة المجلدات قدرة مدفوعة في بعض الخطط) — الرمز 403 مع الرسالة "Your plan does not have folder management quota." يعني أن الخطة لا تتضمنها. سرد المجلدات لا يخضع لهذا الحاجز.

البدء

واجهة الإدارة — الرموز والاستخدام

واجهة الإدارة — رموز QR

واجهة الإدارة — المجلدات والوسوم

واجهة الإدارة — المستخدمون المشتركون والأدوار

واجهة الإدارة — العملاء المحتملون والنماذج

واجهة الإدارة — التحليلات والخطط

ذات صلة

التفويضات

الاستجابة

​ذات صلة

التفويضات

الاستجابة

ذات صلة