Skip to main content
POST
Crear una nueva alerta

Authorizations

Authorization
string
header
required

Token de sesión Better Auth o API token (atk_...) en el header Authorization: Bearer <token>. Los JWT legacy ya no son válidos.

Body

application/json

Payload de creación/edición de alerta según tipo (discriminado por alertTriggerId). La validación exige los campos del tipo correspondiente.

alertTriggerId
string
required

ID del disparador de alerta (determina el tipo y los campos requeridos)

name
string
required

Nombre de la alerta

assets
string[]
required

IDs de activos asociados

users
string[]
required

IDs de usuarios. Si typeNotification.app o typeNotification.browser son true, es obligatorio y debe tener al menos un elemento.

speedLimit
number
required

Límite de velocidad en km/h. Obligatorio para tipo exceso de velocidad. Crea calculator en Flespi automáticamente.

pushUsers
string[]

IDs de los usuarios de la alerta que reciben push (App móvil), elegidos por usuario. Opcional: sin la lista, push va a todos los users si typeNotification.app es true. Cada id tiene que estar en users (si no, 400). Una edición que trae users sin esta lista conserva lo elegido para los que siguen y suma a los nuevos.

socketUsers
string[]

IDs de los usuarios de la alerta que reciben el aviso en pantalla (Navegador), elegidos por usuario. Mismas reglas que pushUsers, con typeNotification.browser.

emails
string<email>[]

Emails para notificaciones. Si typeNotification.email es true, es obligatorio y debe tener al menos un elemento.

phones
string[]

Teléfonos para notificaciones (whatsapp). Cada uno se guarda con + y su código de país (954095508 y +56 9 5409 5508 quedan +56954095508) y una sola vez. Sin +, solo se aceptan números de Chile: 9 dígitos, o 11 que empiezan con 56. Con +56, el número lleva los 9 dígitos de Chile. Un teléfono vacío o inválido se rechaza con 400. Si typeNotification.whatsapp es true, es obligatorio y debe tener al menos un elemento.

typeNotification
object

Canales de notificación. Si un canal está en true, el array asociado no puede estar vacío:

  • email true requiere al menos un email en emails
  • whatsapp true requiere al menos un teléfono en phones
  • app o browser true requieren al menos un usuario en users
state
boolean

Estado de la alerta (true activa, false inactiva)

description
string

Descripción opcional

minDuration
number

Duración mínima en segundos. Por defecto 30 para exceso de velocidad.

Response

Alerta creada exitosamente

status
string
Example:

"success"

data
object

Alerta completa (respuesta del servidor). Incluye todos los campos posibles según el tipo.