curl --request GET \
--url 'https://management.scanova.io/multi-users/access-levels/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 6,
"next": null,
"previous": null,
"results": [
{
"id": 3,
"name": "Viewer",
"slug": "viewer",
"permissions": [
{
"id": 23,
"code": "QR_CODE_CAN_VIEW",
"name": "Can view QR Code",
"description": "Allows viewing QR code details.",
"is_boolean": true
}
],
"is_custom": false
},
{
"id": 4,
"name": "Analyst",
"slug": "analyst",
"permissions": ["..."],
"is_custom": false
},
{
"id": 5,
"name": "Billing Manager",
"slug": "billing-manager",
"permissions": ["..."],
"is_custom": false
},
{
"id": 6,
"name": "Manager",
"slug": "manager",
"permissions": ["..."],
"is_custom": false
},
{
"id": 7,
"name": "Admin",
"slug": "admin",
"permissions": ["..."],
"is_custom": false
},
{
"id": 8,
"name": "Full Access",
"slug": "full-access",
"permissions": ["..."],
"is_custom": false
}
]
}
Management-API — Geteilte Nutzer & Rollen
Rollen auflisten
GET /multi-users/access-levels/
GET
/
multi-users
/
access-levels
/
curl --request GET \
--url 'https://management.scanova.io/multi-users/access-levels/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 6,
"next": null,
"previous": null,
"results": [
{
"id": 3,
"name": "Viewer",
"slug": "viewer",
"permissions": [
{
"id": 23,
"code": "QR_CODE_CAN_VIEW",
"name": "Can view QR Code",
"description": "Allows viewing QR code details.",
"is_boolean": true
}
],
"is_custom": false
},
{
"id": 4,
"name": "Analyst",
"slug": "analyst",
"permissions": ["..."],
"is_custom": false
},
{
"id": 5,
"name": "Billing Manager",
"slug": "billing-manager",
"permissions": ["..."],
"is_custom": false
},
{
"id": 6,
"name": "Manager",
"slug": "manager",
"permissions": ["..."],
"is_custom": false
},
{
"id": 7,
"name": "Admin",
"slug": "admin",
"permissions": ["..."],
"is_custom": false
},
{
"id": 8,
"name": "Full Access",
"slug": "full-access",
"permissions": ["..."],
"is_custom": false
}
]
}
Jedem geteilten Benutzer wird eine Rolle zugewiesen — intern nennt das Scanova-Dashboard diese “Zugriffsebenen” (access levels), und derselbe Begriff taucht in diesem Endpunkt durchgängig auf. Verwenden Sie diesen Endpunkt, um verfügbare Rollen nachzuschlagen, bevor Sie ein Teammitglied über
Ergebnisse werden paginiert (standardmäßig Seitengröße 10) und können neben den 6 System-Standardrollen auch vom Konto erstellte benutzerdefinierte Rollen enthalten.
POST /multi-users/ einladen, oder um eine benutzerdefinierte Rolle aus Ihren eigenen Systemen heraus zu erstellen.
Dieser Endpunkt war bisher nicht dokumentiert. Er erfordert einen Management-API-Schlüssel mit
MANAGEMENT_API- (oder MANAGEMENT_API_SANDBOX-)Quota — siehe die Management-API-Übersicht. Was jede Rolle einem Teammitglied tatsächlich gewährt, erfahren Sie im für Menschen verfassten Leitfaden Rollen & Berechtigungen — diese Seite dokumentiert nur das Wire-Format.curl --request GET \
--url 'https://management.scanova.io/multi-users/access-levels/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 6,
"next": null,
"previous": null,
"results": [
{
"id": 3,
"name": "Viewer",
"slug": "viewer",
"permissions": [
{
"id": 23,
"code": "QR_CODE_CAN_VIEW",
"name": "Can view QR Code",
"description": "Allows viewing QR code details.",
"is_boolean": true
}
],
"is_custom": false
},
{
"id": 4,
"name": "Analyst",
"slug": "analyst",
"permissions": ["..."],
"is_custom": false
},
{
"id": 5,
"name": "Billing Manager",
"slug": "billing-manager",
"permissions": ["..."],
"is_custom": false
},
{
"id": 6,
"name": "Manager",
"slug": "manager",
"permissions": ["..."],
"is_custom": false
},
{
"id": 7,
"name": "Admin",
"slug": "admin",
"permissions": ["..."],
"is_custom": false
},
{
"id": 8,
"name": "Full Access",
"slug": "full-access",
"permissions": ["..."],
"is_custom": false
}
]
}
Live verifiziert: Ein frisches Konto gibt genau diese 6 Systemrollen zurück (Viewer, Analyst, Billing Manager, Manager, Admin, Full Access) — passend zur Auswahl unter Rollen & Berechtigungen in der Schublade “Benutzer einladen” des Dashboards. Die oben gezeigten IDs sind illustrativ; die Berechtigungs-Arrays sind in diesem Beispiel aus Gründen der Kürze gekürzt — eine echte Antwort enthält jede Berechtigung, die die Rolle gewährt, vollständig.
string
Filtert auf
system (die eingebauten Rollen, bei denen user null ist) oder custom (von diesem Konto erstellte Rollen).string
Teilstring-Abgleich gegen den Rollennamen.
string
name oder -name.Antwortfelder (pro Rolle)
integer
Rollen-ID — übergeben Sie diese als
access_level beim Einladen oder Aktualisieren eines geteilten Benutzers.string
Anzeigename der Rolle, z. B.
Manager.string | null
Stabiler Slug für Systemrollen (z. B.
manager); null für benutzerdefinierte Rollen.boolean
false für die 6 eingebauten Systemrollen, true für eine vom Konto selbst erstellte Rolle.array
Jede Berechtigung, die diese Rolle gewährt.
Anzeigen permission properties
Anzeigen permission properties
integer
Berechtigungs-ID — übergeben Sie diese in
permissions, wenn Sie unten eine benutzerdefinierte Rolle erstellen.string
Stabiler Berechtigungscode, z. B.
QR_CODE_CAN_VIEW.string
Für Menschen lesbarer Name der Berechtigung.
string
Längere Beschreibung dessen, was die Berechtigung erlaubt.
boolean
Ob diese Berechtigung ein einfaches Ein/Aus-Flag (
true) ist statt einer numerischen Quota.Verwandte Themen
- Eine benutzerdefinierte Rolle erstellen — die andere Operation an diesem selben Endpunkt.
- Einen geteilten Benutzer einladen — weisen Sie beim Einladen oder Aktualisieren eines Teammitglieds eine Rollen-ID aus dieser Liste zu.
- Einen geteilten Benutzer aktualisieren — weisen Sie beim Einladen oder Aktualisieren eines Teammitglieds eine Rollen-ID aus dieser Liste zu.
- Rollen & Berechtigungen — die für Menschen verfasste Erklärung dessen, was jede Rolle gewährt, einschließlich der Plan-Sperre für benutzerdefinierte Rollen.
- Geteilte Benutzer — die Benutzer-Tabelle des Dashboards, in der diese Rollen über die UI zugewiesen werden.
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 roles, each with its permission set.
War diese Seite hilfreich?
⌘I