Skip to main content
POST
المستخدمون المشاركون هم زملاء الفريق الذين تدعوهم إلى حساب Scanova الخاص بك — نفس القائمة الظاهرة في جدول Users بلوحة التحكم. تتيح لك نقطة النهاية هذه سردهم أو دعوتهم أو تحديثهم أو إزالتهم برمجيًا.
لم تكن نقطة النهاية هذه موثّقة سابقًا. تتطلب مفتاح Management API بحصة MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX)، يُرسل كقيمة خام لترويسة Authorization — راجع نظرة عامة على Management API — بالإضافة إلى حصة الفريق الخاصة بالحساب للمستخدمين المشاركين. لمعرفة ما يمنحه كل دور فعليًا، راجع الأدوار والصلاحيات؛ وللاطلاع على الصيغة السلكية للأدوار نفسها، راجع الأدوار (مستويات الوصول).
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 بلوحة التحكم. لا توجد طريقة لتخطي البريد الإلكتروني عبر نقطة النهاية هذه.

ذات صلة

التفويضات

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.

الجسم

application/json
email
string<email>
مطلوب
name
string
مطلوب
Maximum string length: 20
access_level
integer
مطلوب

Role ID from GET /multi-users/access-levels/.

tags
integer[]
enable_tag_permission
boolean
افتراضي:false
include_untagged
boolean
افتراضي:true

الاستجابة

201 - application/json

Invitation created — sends an invitation email to the shared user.