update_notification
El método update_notification se usa para crear, modificar o eliminar notificaciones.
svc = "resource/update_notification"
params = {
"itemId": <long>,
"id": <long>, // ID de la notificación
"callMode": "<text>",
"e": <bool>,
"n": "<text>", // Nombre
"txt": "<text>", // Texto de la notificación
"ta": <uint>, // Hora de activación (formato Unix)
"td": <uint>, // Hora de desactivación (formato Unix)
"ma": <uint>, // Cantidad máxima de activaciones (0 = ilimitada)
"mmtd": <uint>, // Intervalo de tiempo máximo entre mensajes (s)
"cdt": <uint>, // Tiempo de espera de la activación (s)
"mast": <uint>, // Duración mínima del estado de alarma (s)
"mpst": <uint>, // Duración mínima del estado anterior (s)
"cp": <uint>, // Período de control relativo a la hora actual (s)
"fl": <uint>, // Flags de la notificación
"tz": <int>, // Zona horaria
"la": "<text>", // Idioma del usuario (código de 2 letras)
"un": [<long>], // Matriz de ID de unidades o grupos de unidades
"d": "<text>", // Descripción de la notificación
"sch": { // Horario de la notificación
"f1": <uint>, // Inicio del intervalo 1 (minutos desde medianoche)
"f2": <uint>, // Inicio del intervalo 2 (minutos desde medianoche)
"t1": <uint>, // Fin del intervalo 1 (minutos desde medianoche)
"t2": <uint>, // Fin del intervalo 2 (minutos desde medianoche)
"m": <uint>, // Máscara de días del mes
"y": <uint>, // Máscara de meses
"w": <uint> // Máscara de días de la semana
},
"ctrl_sch": { // Horario de control de la cantidad máxima de activaciones
"f1": <uint>,
"f2": <uint>,
"t1": <uint>,
"t2": <uint>,
"m": <uint>,
"y": <uint>,
"w": <uint>
},
"trg": { // Control
"t": "<text>",
"p": {
"<text>": "<text>",
...
}
},
"act": [ // Acciones
{
"t": "<text>", // Tipo de acción
"p": {
"<text>": "<text>", // Parámetros
...
}
}
]
}
Consulte la descripción de los flags de notificaciones y los tipos de acciones en la página get_notification_data.
Para las notificaciones con el tipo de control Inactividad, el valor del parámetro mast, especificado en segundos, debe corresponder al valor del parámetro min_idle_time, especificado en minutos. Por ejemplo, si desea que la notificación se active después de 10 minutos de inactividad, especifique 10 para min_idle_time y 600 para mast.
Parámetros
| Nombre | Descripción |
|---|---|
| itemId | ID del recurso. |
| id | ID de la notificación (0: crear). |
| callMode | Acción: crear, modificar, eliminar, activar/desactivar (create, update, delete, enable). |
| e | Solo se usa para el callMode “enable”:
|
| d | Descripción de la notificación. Parámetro opcional. Si lo omite al modificar una notificación, la descripción se borra. Para conservar la descripción, pase su valor actual. |
Los demás parámetros solo se requieren para crear y modificar notificaciones. Consulte la página get_notification_data.
Las unidades y los grupos de unidades especificados en el parámetro un se agregan a la notificación solo si el creador del recurso tiene el derecho de acceso Utilizar unidad en tareas, notificaciones, rutas, repetidores sobre ellos. Las demás unidades se omiten sin error.
Resultado devuelto
Para las solicitudes de creación o modificación:
[
<long>, /* ID de la notificación */
{
"id":<long>, /* ID de la notificación */
"n":"<text>", /* nombre */
"txt":"<text>", /* texto de la notificación */
"ta":<uint>, /* hora de activación (formato Unix) */
"td":<uint>, /* hora de desactivación (formato Unix) */
"ma":<uint>, /* cantidad máxima de activaciones (0: ilimitada) */
"fl":<uint>, /* flags de la notificación */
"ac":<uint>, /* cantidad de ejecuciones */
"un":[<long>], /* matriz de ID de unidades/grupos de unidades */
"act":["<text>"], /* acciones */
"trg":"<text>", /* tipo de control */
"trg_p":{}, /* ajustes del control */
"crc":<long>, /* suma de verificación de la representación binaria de la notificación */
"ct":<uint>, /* hora de creación */
"mt":<uint> /* hora de la última modificación */
}
]
Los flags de notificaciones y los tipos de acciones y de control se describen aquí.
Para las solicitudes de eliminación:
[
<long>, /* ID de la notificación */
null
]
Los códigos de error posibles son:
| Código | Descripción |
|---|---|
| 7 | El recurso no existe o el usuario no tiene el derecho de acceso Crear, modificar y eliminar notificaciones a él. |
| 6 | Error no definido. |
| 4 | Parámetros de entrada incorrectos. |