Wialon para desarrolladores Manual de usuario Documentación de API user update_user_notification

update_user_notification

Para enviar una notificación en línea a un usuario, utilice el método user/update_user_notification.

Creación

Copied!
svc=user/update_user_notification&params={
											"itemId":<long>, /*obligatorio*/
 										  	"callMode":"<text>", /*obligatorio*/
 										 	"h":"<text>", /*obligatorio*/
 										  	"d":"{ /*obligatorio*/
 										  		\"body\":\"<text>\",
 												\"head\":{
 													\"c\":<uint>,
 													\"fs\":\"<text>\"
										  		},
 										  		\"multiple\":<int>
										  	}",
 										  	"s":"<text>", /*obligatorio*/
 										  	"ttl":<uint> /*obligatorio*/
										}

Eliminación

Copied!
svc=user/update_user_notification&params={
											"itemId":<long>, /*obligatorio*/
											"id":<long>, /*obligatorio*/
											"callMode":"<text>" /*obligatorio*/
										 }

Parámetros

Los parámetros obligatorios están marcados con un asterisco (*).

Parámetros de creación

Nombre Descripción
itemId* ID del usuario.
callMode* Tipo de acción (debe ser “create” para la creación).
h* Asunto.
d* Ajustes del texto del mensaje.
body* Texto.
c* Color, RGB.
fs* Tamaño de fuente.
multiple* Activación múltiple: 1 — sí, 0 — no.
s* Remitente.
ttl* Tiempo de vida (UTC). Cuando vence el tiempo de vida, la notificación se elimina.

Parámetros de eliminación

Nombre Descripción
itemId* ID del usuario.
id* ID de la notificación.
callMode* Tipo de acción (debe ser “delete” para la eliminación).

Si el parámetro ttl indica una fecha en el pasado, las notificaciones se activan solo en línea (no se almacenan en el servidor). El parámetro ttl es una fecha en segundos desde el 1 de enero de 1970 (tiempo UNIX).

Respuesta

Respuesta a la creación:

Copied!
[
	<long>,		/* ID de la notificación */
	{
		"id":<long>,	/* ID de la notificación */
		"t":<uint>,	/* tiempo de vida (UTC) */
		"d":"<text>",	/* ajustes del texto del mensaje */
		"h":"<text>",	/* asunto */
		"s":"<text>"	/* remitente */
	}
]

Respuesta a la eliminación:

Copied!
[
	<long>, 	/* ID de la notificación */
	null
]

Códigos de error

Código de error Descripción
7 No se encontró el usuario o usted no tiene el derecho de acceso Modificar propiedades no mencionadas a este usuario.
6 No se pudo crear o eliminar la notificación.
4 Modo incorrecto (debe ser “create” o “delete”), se pasaron parámetros incorrectos o los ajustes del texto del mensaje (d) superan el tamaño máximo (30 KB por defecto).

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