curl --request GET \
--url 'https://management.scanova.io/tag/list/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"id": 3369,
"name": "docs-v2-test-tag"
}
]
}
واجهة الإدارة — المجلدات والوسوم
إدارة الوسوم
GET /tag/list/
GET
/
tag
/
list
/
curl --request GET \
--url 'https://management.scanova.io/tag/list/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"id": 3369,
"name": "docs-v2-test-tag"
}
]
}
الوسوم هي التصنيفات المُرفقة برموز QR للتصفية وإعداد التقارير — نفس الوسوم الظاهرة كشرائح (chips) في قائمة QR Codes بلوحة التحكم. تعيد نقطة النهاية هذه الوسوم المرئية للحساب المصادَق عليه، للقراءة فقط.
النتائج مُرقّمة إلى صفحات (حجم الصفحة 10 افتراضيًا، حتى 100 عبر
يتطلب مفتاح Management API بحصة
MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX)، يُرسل كقيمة خام لترويسة Authorization. راجع نظرة عامة على Management API.سرد الوسوم
curl --request GET \
--url 'https://management.scanova.io/tag/list/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"id": 3369,
"name": "docs-v2-test-tag"
}
]
}
page_size).
string
مطابقة بادئة غير حسّاسة لحالة الأحرف — تعيد الوسوم التي يبدأ اسمها بهذه القيمة.
integer
رقم الصفحة المطلوب جلبها.
integer
افتراضي:"10"
عدد الوسوم لكل صفحة. الحد الأقصى 100.
حقول الاستجابة
integer
معرّف الوسم.
string
اسم الوسم، يُعاد دائمًا بأحرف صغيرة بغض النظر عن كيفية إدخاله أصلًا.
تقتصر هذه القائمة على الوسوم المُرفقة فعليًا (أو القابلة للإسناد) برموز QR الخاصة بالحساب نفسه — إنها ليست دليل وسوم عامًا. إذا كان الحساب يُفعِّل صلاحيات المستخدم المشارك القائمة على الوسوم، يمكن للمجموعة المُعادة أن تعتمد إضافيًا على الوسوم التي يقتصر عليها الحساب المصادَق عليه.
لا توجد نقطة نهاية إنشاء/حذف مقابلة في Management API — تُنشأ الوسوم ضمنيًا عند إرفاقها برمز QR (عبر لوحة التحكم، أو نقاط نهاية إنشاء/تحديث رموز QR، أو العمليات الجماعية)، لا عبر استدعاء إدارة وسوم مستقل.
ذات صلة
- إدارة المجلدات — آلية تنظيم رموز QR الأخرى، تُستخدم جنبًا إلى جنب مع الوسوم (أو بدلًا منها).
- سرد / إنشاء رموز QR — صفِّ رموز QR حسب اسم وسم عبر
?tags=. - إدارة المستخدمين المشاركين — حيث يُستخدم معرّف وسم من هذه القائمة لتحديد نطاق رؤية زميل.
- الأدوار والصلاحيات — كيف يعمل تحديد النطاق القائم على الوسوم من جانب لوحة التحكم.
التفويضات
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 tags
هل كانت هذه الصفحة مفيدة؟
⌘I