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.

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).

Copied!
{
	"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.

Copied!
{
	"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).

Copied!
{
	"crt": <uint>,	/* ID del creador */
	"bact": <uint>	/* ID de la cuenta */
}

Campos personalizados

El flag de los campos personalizados es 0x00000008 (8).

Copied!
{
	"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).

Copied!
{
	"gd": "<text>"	/* GUID del usuario */
}

Campos administrativos

El flag de los campos administrativos es 0x00000080 (128).

Copied!
{
	"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).

Copied!
{
	"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).

Copied!
{
	"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).

Copied!
{
	"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.

Si nota un error en el texto, por favor resáltelo y presione Ctrl+Intro.