curl --request POST \
--url 'https://management.scanova.io/multi-users/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"email": "teammate@example.com",
"name": "Jordan Lee",
"access_level": 5
}'
{
"id": 118,
"shared_user": {
"id": 88213,
"first_name": "Jordan",
"last_name": "Lee",
"full_name": "Jordan Lee",
"email": "teammate@example.com",
"is_active": false,
"is_locked": false
},
"access_level": {
"id": 5,
"name": "Manager",
"slug": "manager",
"permissions": [],
"is_custom": false
},
"invitation_sent_on": null,
"invitation_accepted_on": null,
"is_invitation_sent": false,
"is_invitation_accepted": false,
"status": "Invitation Sent",
"is_active": false,
"created": "2026-08-16T20:41:09.442000+05:30",
"modified": "2026-08-16T20:41:09.442000+05:30",
"include_untagged": true,
"enable_tag_permission": false,
"tags": []
}
واجهة الإدارة — المستخدمون المشتركون والأدوار
دعوة مستخدم مشارك
POST /multi-users/
POST
/
multi-users
/
curl --request POST \
--url 'https://management.scanova.io/multi-users/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"email": "teammate@example.com",
"name": "Jordan Lee",
"access_level": 5
}'
{
"id": 118,
"shared_user": {
"id": 88213,
"first_name": "Jordan",
"last_name": "Lee",
"full_name": "Jordan Lee",
"email": "teammate@example.com",
"is_active": false,
"is_locked": false
},
"access_level": {
"id": 5,
"name": "Manager",
"slug": "manager",
"permissions": [],
"is_custom": false
},
"invitation_sent_on": null,
"invitation_accepted_on": null,
"is_invitation_sent": false,
"is_invitation_accepted": false,
"status": "Invitation Sent",
"is_active": false,
"created": "2026-08-16T20:41:09.442000+05:30",
"modified": "2026-08-16T20:41:09.442000+05:30",
"include_untagged": true,
"enable_tag_permission": false,
"tags": []
}
المستخدمون المشاركون هم زملاء الفريق الذين تدعوهم إلى حساب Scanova الخاص بك — نفس القائمة الظاهرة في جدول Users بلوحة التحكم. تتيح لك نقطة النهاية هذه سردهم أو دعوتهم أو تحديثهم أو إزالتهم برمجيًا.
لم تكن نقطة النهاية هذه موثّقة سابقًا. تتطلب مفتاح Management API بحصة
MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX)، يُرسل كقيمة خام لترويسة Authorization — راجع نظرة عامة على Management API — بالإضافة إلى حصة الفريق الخاصة بالحساب للمستخدمين المشاركين. لمعرفة ما يمنحه كل دور فعليًا، راجع الأدوار والصلاحيات؛ وللاطلاع على الصيغة السلكية للأدوار نفسها، راجع الأدوار (مستويات الوصول).curl --request POST \
--url 'https://management.scanova.io/multi-users/' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
"email": "teammate@example.com",
"name": "Jordan Lee",
"access_level": 5
}'
{
"id": 118,
"shared_user": {
"id": 88213,
"first_name": "Jordan",
"last_name": "Lee",
"full_name": "Jordan Lee",
"email": "teammate@example.com",
"is_active": false,
"is_locked": false
},
"access_level": {
"id": 5,
"name": "Manager",
"slug": "manager",
"permissions": [],
"is_custom": false
},
"invitation_sent_on": null,
"invitation_accepted_on": null,
"is_invitation_sent": false,
"is_invitation_accepted": false,
"status": "Invitation Sent",
"is_active": false,
"created": "2026-08-16T20:41:09.442000+05:30",
"modified": "2026-08-16T20:41:09.442000+05:30",
"include_untagged": true,
"enable_tag_permission": false,
"tags": []
}
string
مطلوب
عنوان البريد الإلكتروني للزميل الجديد. يجب ألا ينتمي مسبقًا إلى مستخدم Scanova آخر — التكرار يعيد 400 مع
{"email": ["Email address is already used."]}.string
مطلوب
اسم العرض، حتى 20 حرفًا.
integer
مطلوب
معرّف دور من
GET /multi-users/access-levels/ — إما دور نظام افتراضي أو دور مخصص أنشأه هذا الحساب.array
معرّفات وسوم لتقييد وصول هذا المستخدم بها. تتطلب حصة
CUSTOM_TAG/صلاحية الوسوم الخاصة بالحساب — وإلا تُرفض بـ 403.boolean
افتراضي:"false"
تقييد رموز QR المرئية لهذا المستخدم بـ
tags.boolean
افتراضي:"true"
عندما تكون
enable_tag_permission صحيحة، ما إذا كانت رموز QR غير الموسومة لا تزال مرئية.دعوة زميل تُرسل له دائمًا بريد دعوة — إنشاء السجل هنا له نفس تأثير النقر على Invite Users في جدول Users بلوحة التحكم. لا توجد طريقة لتخطي البريد الإلكتروني عبر نقطة النهاية هذه.
ذات صلة
- سرد المستخدمين المشاركين — العملية الأخرى لنفس نقطة النهاية هذه.
- استرجاع مستخدم مشارك — اعمل على سجل المستخدم المشارك بعد دعوته.
- تحديث مستخدم مشارك — اعمل على سجل المستخدم المشارك بعد دعوته.
- إزالة مستخدم مشارك — اعمل على سجل المستخدم المشارك بعد دعوته.
- سرد الأدوار — ابحث عن معرّف
access_levelأو أنشئه، وهو ما تتطلبه استدعاءات الدعوة/التحديث في نقطة النهاية هذه. - إنشاء دور مخصص — ابحث عن معرّف
access_levelأو أنشئه، وهو ما تتطلبه استدعاءات الدعوة/التحديث في نقطة النهاية هذه. - المستخدمون المشاركون — جدول Users الخاص بلوحة التحكم نفسها، يعرض نفس إجراءات الدعوة/التعطيل/الإزالة.
- الأدوار والصلاحيات — ما يمنحه كل دور فعليًا لزميل.
التفويضات
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.
الجسم
application/json
الاستجابة
201 - application/json
Invitation created — sends an invitation email to the shared user.
هل كانت هذه الصفحة مفيدة؟
⌘I