Usuarios
Dependiendo de los flags especificados, el formato de respuesta puede variar.
Este capítulo describe los flags que se pueden aplicar a los usuarios y las partes correspondientes del JSON resultante que controlan. Si se especifican varios flags, sus respectivas partes se combinan en un solo JSON.
Indique los flags en formato DEC. Para obtener más información, consulte Formato de datos.
El contenido de la respuesta también depende de sus derechos de acceso al elemento. Para obtener más información, consulte Flags y derechos de acceso.
Flags de usuarios
Los siguientes flags pueden aplicarse a los usuarios:
| Valor HEX | Valor DEC | Descripción |
|---|---|---|
| 0x00000001 | 1 | Propiedades básicas (flag base) |
| 0x00000002 | 2 | Propiedades personalizadas |
| 0x00000004 | 4 | Información de facturación |
| 0x00000008 | 8 | Campos personalizados |
| 0x00000020 | 32 | Mensajes (solo suscripción) |
| 0x00000040 | 64 | GUID |
| 0x00000080 | 128 | Campos administrativos |
| 0x00000100 | 256 | Otras propiedades del usuario, incluida la máscara de host |
| 0x00000200 | 512 | Notificaciones |
| 0x00000800 | 2048 | Aplicaciones móviles del usuario |
| 0x3FFFFFFFFFFFFFFF | 4611686018427387903 | Establecer todos los flags de usuario |
Propiedades básicas
El flag de las propiedades básicas es 0x00000001 (1).
{
"nm": "<text>", /* Nombre de usuario */
"cls": <uint>, /* ID de superclase de user, normalmente 1 (consulte la clave classes en la respuesta de token/login) */
"id": <uint>, /* ID del usuario */
"mu": <uint>, /* Sistema de medida:
0 — métrico (SI),
1 — estadounidense,
2 — imperial,
3 — métrico con galones */
"uacl": <long> /* Derechos de acceso del usuario a este usuario (valor de 64 bits) */
}
Propiedades personalizadas
El flag de las propiedades personalizadas es 0x00000002 (2).
El objeto prp contiene las propiedades personalizadas que la interfaz de Wialon y las aplicaciones almacenan para el usuario, por lo que el conjunto de claves varía. A continuación se muestran algunas de las claves como ejemplo.
{
"prp": {
"tz": "<text>", /* Zona horaria, consulte Ejemplo de obtención del parámetro tz */
"language": "<text>", /* Idioma de la interfaz */
"cfmt": "<text>", /* Formato de coordenadas: 0 — grados y minutos, 1 — grados */
"email": "<text>", /* Email del usuario */
"msc": "<text>", /* Posición del mapa después de iniciar sesión: 0 — predeterminada, 1 — guardada */
"poisrv": "<text>" /* Representar los POI en el servidor */
},
"ftp": { /* Configuración FTP (solo se utiliza para cuentas) */
"hs": "<text>", /* Host (solo si está configurado) */
"lg": "<text>", /* Inicio de sesión (solo si está configurado) */
"pt": "<text>", /* Ruta del directorio (solo si está configurada) */
"ch": <uint>, /* Validez de la configuración FTP: 1 para sí, 0 para no */
"tp": <uint>, /* Usar FTP de Wialon Hosting: 1 para sí, 0 para no */
"fl": <uint> /* Disponibilidad de FTP de Wialon Hosting: 1 para sí, 0 para no */
},
"ct": <uint> /* Hora de creación (marca de tiempo Unix) */
}
Información de facturación
El flag de la información de facturación es 0x00000004 (4).
{
"crt": <uint>, /* ID del creador */
"bact": <uint> /* ID de la cuenta */
}
Campos personalizados
El flag de los campos personalizados es 0x00000008 (8).
{
"flds": { /* Campos personalizados */
"<text>": { /* ID del campo personalizado */
"id": <uint>, /* ID */
"n": "<text>", /* Nombre */
"v": "<text>", /* Valor */
"ct": <uint>, /* Hora de creación (marca de tiempo Unix) */
"mt": <uint> /* Hora de la última modificación (marca de tiempo Unix) */
}
},
"fldsmax": <long> /* Cantidad máxima de campos personalizados permitida por el plan de facturación de la cuenta (-1 para ilimitado). Puede ser 0 si el servicio no está incluido en el plan de facturación; los campos personalizados existentes se siguen devolviendo */
}
Mensajes
El flag de los mensajes es 0x00000020 (32).
Este flag no agrega ningún dato a la respuesta. Suscribe la sesión a los mensajes nuevos del usuario.
Para utilizarlo, establezca el flag para el usuario con core/update_data_flags. Después de eso, cada mensaje nuevo registrado para el usuario se entrega como un evento en avl_evts. Los tipos de mensajes y su formato se describen en la página Mensajes.
Se recomienda combinar este flag con el flag de las propiedades básicas 0x00000001 (1). Por sí solo, el flag de los mensajes hace que core/update_data_flags devuelva un objeto d vacío, lo que parece indicar que la suscripción falló.
GUID
El flag del GUID es 0x00000040 (64).
{
"gd": "<text>" /* GUID del usuario */
}
Campos administrativos
El flag de los campos administrativos es 0x00000080 (128).
{
"aflds": { /* Campos administrativos */
"<text>": { /* ID del campo administrativo */
"id": <uint>, /* ID */
"n": "<text>", /* Nombre */
"v": "<text>", /* Valor */
"ct": <uint>, /* Hora de creación (marca de tiempo Unix) */
"mt": <uint> /* Hora de la última modificación (marca de tiempo Unix) */
},
...
},
"afldsmax": <long> /* Cantidad máxima de campos administrativos permitida por el plan de facturación de la cuenta (-1 para ilimitado). Puede ser 0 si el servicio no está incluido en el plan de facturación; los campos administrativos existentes se siguen devolviendo */
}
Otras propiedades del usuario
El flag de las otras propiedades del usuario es 0x00000100 (256).
{
"fl": <uint>, /* Flags de los ajustes del usuario */
"hm": "<text>", /* Máscara de host */
"ld": <uint>, /* Hora del último inicio de sesión */
"pfl": <uint>, /* Flags permitidos por las cuentas principales */
"ap": { /* Parámetros de autenticación. No se incluye si no están configurados */
"type": <uint>, /* Tipo de autenticación de dos factores: 0 — ninguna, 1 — email, 2 — SMS */
"phone": "<text>", /* Número de teléfono para la autenticación de dos factores */
"gmail": "<text>" /* Email del servicio de autenticación conectado */
}
}
Los flags de los ajustes del usuario se enumeran en la página user/update_user_flags. El valor pfl utiliza los mismos flags: contiene los flags establecidos en todas las cuentas principales del usuario, hacia arriba en la jerarquía.
El objeto ap se devuelve solo si los parámetros de autenticación se configuraron con user/update_auth_params o user/bind_auth_service. El nombre de la clave del servicio de autenticación depende del servicio, por ejemplo, gmail.
Notificaciones
El flag de las notificaciones es 0x00000200 (512).
{
"usnf": { /* Notificaciones del usuario */
"<text>": { /* ID de la notificación */
"id": <long>, /* ID */
"t": <uint>, /* Tiempo de vida (segundos) */
"d": "<text>", /* Texto de la notificación */
"h": "<text>", /* Asunto */
"s": "<text>", /* Remitente */
"ct": <uint>, /* Hora de creación (marca de tiempo Unix) */
"mt": <uint> /* Hora de la última modificación (marca de tiempo Unix) */
}
}
}
Aplicaciones móviles del usuario
El flag de las aplicaciones móviles del usuario es 0x00000800 (2048).
{
"mapps": { /* Aplicaciones móviles */
"<text>": { /* ID de la aplicación móvil */
"id": <long>, /* ID */
"n": "<text>", /* Nombre */
"uid": "<text>", /* Token del dispositivo para notificaciones push */
"cp": {}, /* Parámetros personalizados establecidos por la aplicación móvil */
"as": {}, /* Especificación de la aplicación establecida por la aplicación móvil */
"e": <uint>, /* Habilitada: 1 para sí, 0 para no */
"ct": <uint>, /* Hora de creación (marca de tiempo Unix) */
"mt": <uint> /* Hora de la última modificación (marca de tiempo Unix) */
}
},
"mappsmax": <long> /* Cantidad máxima de aplicaciones móviles permitida por el plan de facturación de la cuenta (-1 para ilimitado). Puede ser 0 si el servicio no está incluido en el plan de facturación; las aplicaciones móviles existentes se siguen devolviendo */
}
La clave mapps requiere el derecho de acceso al usuario Ver detalle de propiedades de objeto, y mappsmax requiere Actuar en nombre del usuario.