curl --request GET \
--url 'https://management.scanova.io/multi-users/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 0,
"next": null,
"previous": null,
"results": []
}
API de gestión — Usuarios compartidos y roles
Listar usuarios compartidos
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": []
}
Los usuarios compartidos son los compañeros de equipo que invitas a tu cuenta de Scanova — la misma lista que se muestra en la tabla Users del panel. Este endpoint te permite listarlos, invitarlos, actualizarlos o eliminarlos de forma programática.
Este endpoint no estaba documentado anteriormente. Requiere una clave de la API de gestión con cuota
MANAGEMENT_API (o MANAGEMENT_API_SANDBOX), enviada como el valor sin procesar del encabezado Authorization — consulta el resumen de la API de gestión — además de la propia cuota de Team de la cuenta para usuarios compartidos. Para saber qué otorga realmente cada rol, consulta Roles y permisos; para el formato de transmisión de los propios roles, consulta Roles (niveles de acceso).curl --request GET \
--url 'https://management.scanova.io/multi-users/' \
--header 'Authorization: YOUR_API_KEY'
{
"count": 0,
"next": null,
"previous": null,
"results": []
}
Verificado en vivo contra una cuenta de prueba sin compañeros de equipo invitados todavía — de ahí el
results vacío. La forma que se muestra a continuación (del serializador subyacente) es cómo se ve cada entrada una vez que existen compañeros de equipo.string
Filtro de coincidencia exacta con la dirección de correo electrónico del usuario compartido.
string
Coincidencia de subcadena sin distinción de mayúsculas y minúsculas con el nombre del usuario compartido.
string
Nombres de rol separados por comas para filtrar, p. ej.
Admin,Manager.string
Uno de
invitation_sent, active, inactive.string
Uno de
enabled, disabled, pending.string
shared_user__email, shared_user__first_name, o cualquiera de ellos precedido de - para orden descendente.Campos de la respuesta (por entrada)
integer
ID del registro de usuario compartido — úsalo como
{pk} para los endpoints de obtener/actualizar/eliminar a continuación.object
object
El rol asignado, con la misma forma que devuelve
GET /multi-users/access-levels/.string
Estado calculado:
Invitation Sent, Active, Inactive (sin inicio de sesión en 60+ días) o Locked.boolean
Si la cuenta del usuario compartido está activa (distinto de
status — un usuario desactivado siempre muestra is_active: false independientemente del estado de la invitación).string | null
Marca de tiempo ISO 8601 del correo de invitación (más reciente).
string | null
Marca de tiempo ISO 8601 de cuándo se aceptó la invitación, o
null si aún está pendiente.boolean
Si es verdadero, la visibilidad de códigos QR de este usuario se restringe a las etiquetas en
tags a continuación.boolean
Cuando el permiso basado en etiquetas está habilitado, si el usuario también puede ver códigos QR sin etiquetar.
array
Etiquetas a las que está limitado este usuario (solo relevante cuando
enable_tag_permission es verdadero), en forma {id, name}.string
string
Relacionado
- Invitar a un usuario compartido — la otra operación de este mismo endpoint.
- Obtener un usuario compartido — opera sobre un único usuario compartido devuelto por esta lista.
- Actualizar un usuario compartido — opera sobre un único usuario compartido devuelto por esta lista.
- Eliminar un usuario compartido — opera sobre un único usuario compartido devuelto por esta lista.
- Listar roles — busca o crea el ID de
access_levelque requieren las llamadas de invitar/actualizar de este endpoint. - Crear un rol personalizado — busca o crea el ID de
access_levelque requieren las llamadas de invitar/actualizar de este endpoint. - Usuarios compartidos — la propia tabla Users del panel, que muestra las mismas acciones de invitar/desactivar/eliminar.
- Roles y permisos — qué otorga realmente cada rol a un compañero de equipo.
Autorizaciones
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.
Respuesta
200 - application/json
Paginated list of shared users invited to this account.
¿Esta página le ayudó?
⌘I