curl --request GET \
--url 'https://management.scanova.io/multi-users/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 0,
"next": null,
"previous": null,
"results": []
}
API de gestion — Utilisateurs partagés et rôles
Lister les utilisateurs partagés
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": []
}
Les utilisateurs partagés sont les coéquipiers que vous invitez dans votre compte Scanova — la même liste affichée dans le tableau Users du tableau de bord. Cet endpoint vous permet de les lister, de les inviter, de les mettre à jour ou de les supprimer de manière programmatique.
Cet endpoint n’était pas documenté auparavant. Il nécessite une clé Management API avec le quota
MANAGEMENT_API (ou MANAGEMENT_API_SANDBOX), envoyée comme valeur brute de l’en-tête Authorization — voir la vue d’ensemble de la Management API — ainsi que le propre quota Team du compte pour les utilisateurs partagés. Pour ce que chaque rôle accorde réellement, voir Rôles et permissions ; pour le format des rôles eux-mêmes, voir Rôles (niveaux d’accès).curl --request GET \
--url 'https://management.scanova.io/multi-users/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 0,
"next": null,
"previous": null,
"results": []
}
Vérifié en conditions réelles sur un compte de test sans coéquipier invité — d’où le
results vide. La structure ci-dessous (issue du serializer sous-jacent) est celle de chaque entrée une fois que des coéquipiers existent.string
Filtre par correspondance exacte sur l’adresse e-mail de l’utilisateur partagé.
string
Correspondance de sous-chaîne insensible à la casse par rapport au prénom de l’utilisateur partagé.
string
Noms de rôles séparés par des virgules pour filtrer, par ex.
Admin,Manager.string
L’un de
invitation_sent, active, inactive.string
L’un de
enabled, disabled, pending.string
shared_user__email, shared_user__first_name, ou l’un des deux préfixé de - pour un tri descendant.Champs de réponse (par entrée)
integer
ID de l’enregistrement d’utilisateur partagé — à utiliser comme
{pk} pour les endpoints de récupération/mise à jour/suppression ci-dessous.object
object
Le rôle attribué, dans la même structure que celle renvoyée par
GET /multi-users/access-levels/.string
Statut calculé :
Invitation Sent, Active, Inactive (aucune connexion depuis 60+ jours), ou Locked.boolean
Indique si le compte de l’utilisateur partagé est actif (distinct de
status — un utilisateur désactivé affiche toujours is_active: false, quel que soit l’état de l’invitation).string | null
Horodatage ISO 8601 du (dernier) e-mail d’invitation.
string | null
Horodatage ISO 8601 du moment où l’invitation a été acceptée, ou
null si elle est toujours en attente.boolean
Si vrai, la visibilité des QR codes de cet utilisateur est restreinte aux tags listés dans
tags ci-dessous.boolean
Lorsque la permission basée sur les tags est activée, indique si l’utilisateur peut également voir les QR codes sans tag.
array
Tags auxquels cet utilisateur est limité (uniquement pertinent lorsque
enable_tag_permission est vrai), sous la forme {id, name}.string
string
Voir aussi
- Inviter un utilisateur partagé — l’autre opération de ce même endpoint.
- Récupérer un utilisateur partagé — opérez sur un utilisateur partagé unique renvoyé par cette liste.
- Mettre à jour un utilisateur partagé — opérez sur un utilisateur partagé unique renvoyé par cette liste.
- Supprimer un utilisateur partagé — opérez sur un utilisateur partagé unique renvoyé par cette liste.
- Lister les rôles — recherchez ou créez l’ID
access_levelrequis par les appels d’invitation/mise à jour de cet endpoint. - Créer un rôle personnalisé — recherchez ou créez l’ID
access_levelrequis par les appels d’invitation/mise à jour de cet endpoint. - Utilisateurs partagés — le tableau Users du tableau de bord, montrant les mêmes actions d’invitation/désactivation/suppression.
- Rôles et permissions — ce que chaque rôle accorde réellement à un coéquipier.
Autorisations
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.
Réponse
200 - application/json
Paginated list of shared users invited to this account.
Cette page vous a-t-elle été utile ?
⌘I