curl --request GET \
--url 'https://management.scanova.io/multi-users/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 0,
"next": null,
"previous": null,
"results": []
}
Management-API — Geteilte Nutzer & Rollen
Geteilte Benutzer auflisten
GET /multi-users/
GET
/
multi-users
/
curl --request GET \
--url 'https://management.scanova.io/multi-users/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 0,
"next": null,
"previous": null,
"results": []
}
Geteilte Benutzer sind die Teammitglieder, die Sie in Ihr Scanova-Konto einladen — dieselbe Liste, die in der Benutzer-Tabelle des Dashboards angezeigt wird. Mit diesem Endpunkt können Sie sie programmatisch auflisten, einladen, aktualisieren oder entfernen.
Dieser Endpunkt war bisher nicht dokumentiert. Er erfordert einen Management-API-Schlüssel mit
MANAGEMENT_API- (oder MANAGEMENT_API_SANDBOX-)Quota, gesendet als roher Authorization-Header-Wert — siehe die Management-API-Übersicht — sowie die eigene Team-Quota des Kontos für geteilte Benutzer. Was jede Rolle tatsächlich gewährt, erfahren Sie unter Rollen & Berechtigungen; das Wire-Format der Rollen selbst finden Sie unter Rollen (Zugriffsebenen).curl --request GET \
--url 'https://management.scanova.io/multi-users/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 0,
"next": null,
"previous": null,
"results": []
}
Live gegen ein Test-Konto ohne bisher eingeladene Teammitglieder verifiziert — daher die leeren
results. Die untenstehende Form (aus dem zugrunde liegenden Serializer) zeigt, wie jeder Eintrag aussieht, sobald Teammitglieder existieren.string
Exakter Abgleich der E-Mail-Adresse des geteilten Benutzers.
string
Groß-/Kleinschreibung ignorierender Teilstring-Abgleich gegen den Vornamen des geteilten Benutzers.
string
Kommagetrennte Rollennamen zum Filtern, z. B.
Admin,Manager.string
Einer von
invitation_sent, active, inactive.string
Einer von
enabled, disabled, pending.string
shared_user__email, shared_user__first_name, oder eines davon mit vorangestelltem - für absteigende Sortierung.Antwortfelder (pro Eintrag)
integer
Datensatz-ID des geteilten Benutzers — verwenden Sie diese als
{pk} für die unten stehenden Abruf-/Aktualisierungs-/Löschungs-Endpunkte.object
object
Die zugewiesene Rolle, in derselben Form, die von
GET /multi-users/access-levels/ zurückgegeben wird.string
Berechneter Status:
Invitation Sent, Active, Inactive (60+ Tage kein Login) oder Locked.boolean
Ob das Konto des geteilten Benutzers aktiv ist (zu unterscheiden von
status — ein deaktivierter Benutzer zeigt immer is_active: false, unabhängig vom Einladungsstatus).string | null
ISO-8601-Zeitstempel der (letzten) Einladungs-E-Mail.
string | null
ISO-8601-Zeitstempel, wann die Einladung angenommen wurde, oder
null, falls noch ausstehend.boolean
Falls wahr, ist die Sichtbarkeit von QR-Codes für diesen Benutzer auf die Tags in
tags unten beschränkt.boolean
Bei aktivierter tag-basierter Berechtigung: ob der Benutzer auch nicht getaggte QR-Codes sehen kann.
array
Tags, auf die dieser Benutzer beschränkt ist (nur relevant, wenn
enable_tag_permission wahr ist), in der Form {id, name}.string
string
Verwandte Themen
- Einen geteilten Benutzer einladen — die andere Operation an diesem selben Endpunkt.
- Einen geteilten Benutzer abrufen — mit einem einzelnen geteilten Benutzer arbeiten, der von dieser Liste zurückgegeben wird.
- Einen geteilten Benutzer aktualisieren — mit einem einzelnen geteilten Benutzer arbeiten, der von dieser Liste zurückgegeben wird.
- Einen geteilten Benutzer entfernen — mit einem einzelnen geteilten Benutzer arbeiten, der von dieser Liste zurückgegeben wird.
- Rollen auflisten — suchen oder erstellen Sie die
access_level-ID, die die Einladungs-/Aktualisierungs-Aufrufe dieses Endpunkts benötigen. - Eine benutzerdefinierte Rolle erstellen — suchen oder erstellen Sie die
access_level-ID, die die Einladungs-/Aktualisierungs-Aufrufe dieses Endpunkts benötigen. - Geteilte Benutzer — die eigene Benutzer-Tabelle des Dashboards, die dieselben Einladungs-/Deaktivierungs-/Entfernungs-Aktionen zeigt.
- Rollen & Berechtigungen — was jede Rolle einem Teammitglied tatsächlich gewährt.
Autorisierungen
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.
Antwort
200 - application/json
Paginated list of shared users invited to this account.
War diese Seite hilfreich?
⌘I