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 الخاصة بالحساب نفسه — إنها ليست دليل وسوم عامًا. إذا كان الحساب يُفعِّل صلاحيات المستخدم المشارك القائمة على الوسوم، يمكن للمجموعة المُعادة أن تعتمد إضافيًا على الوسوم التي يقتصر عليها الحساب المصادَق عليه.
هذا الطرف نفسه للقراءة فقط — لا تزال الوسوم تُنشأ ضمنيًا عند إرفاقها برمز 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
هل كانت هذه الصفحة مفيدة؟