Saltar al contenido principal
GET
/
notifications
Listar Grupos de Notificación
curl --request GET \
  --url https://api.altostrat.io/notifications \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "ntfgrp_9b01a14c-1123-4279-88b1-3e42f9b846e1",
    "name": "Alertas del Equipo de Guardia Principal",
    "schedule_id": "sch_7d1b8c0c-5121-4f27-849c-29b3a0e6201a",
    "mute": "schedule-active",
    "notifiables": [
      {
        "id": "usr_5f0b6e1b-4f1e-4b4a-8b0a-0e6f0b6e1b4f",
        "channel": "whatsapp"
      }
    ],
    "topics": [
      "top_9cffb446-18a5-445a-948c-e6f1d98930af",
      "top_9ba5d51f-3ada-44f2-9fb9-bf2404a29f50"
    ],
    "sites": [
      "site_a2b3c4d5-e6f7-g8h9-i0j1-k2l3m4n5o6p7",
      "site_b3c4d5e6-f7g8-h9i0-j1k2-l3m4n5o6p7q8"
    ],
    "created_at": "2025-10-29T12:24:17.000Z",
    "updated_at": "2025-10-29T12:28:00.000Z"
  }
]

Authorizations

​
Authorization
string
header
required

Altostrat utiliza OAuth2 para la autenticación. Los tokens se pueden obtener de la API de Autenticación de Altostrat.

Response

Una lista de grupos de notificación.

​
id
string<uuid>

El identificador único para el grupo de notificación.

Example:

"ntfgrp_9b01a14c-1123-4279-88b1-3e42f9b846e1"

​
name
string

Un nombre legible por humanos para el grupo de notificación.

Example:

"Alertas del Equipo de Guardia Principal"

​
schedule_id
string<uuid>

El UUID de un objeto Schedule de la API Chrono, que define cuándo está activo este grupo.

Example:

"sch_7d1b8c0c-5121-4f27-849c-29b3a0e6201a"

​
mute
enum<string>

Controla el estado de silencio del grupo. schedule-active silencia cuando el horario está inactivo, schedule-inactive silencia cuando el horario está activo. never y always son estados absolutos.

Opciones disponibles:
schedule-active,
schedule-inactive,
never,
always
Example:

"schedule-active"

​
notifiables
object[]

Una matriz de destinatarios y sus canales de notificación designados.

​
topics
string<uuid>[]

Una matriz de UUIDs de Temas a los que este grupo se suscribe.

Example:
[
  "top_9cffb446-18a5-445a-948c-e6f1d98930af",
  "top_9ba5d51f-3ada-44f2-9fb9-bf2404a29f50"
]
​
sites
string<uuid>[]

Una matriz de UUIDs de Sitios para los cuales este grupo recibirá notificaciones.

Example:
[
  "site_a2b3c4d5-e6f7-g8h9-i0j1-k2l3m4n5o6p7",
  "site_b3c4d5e6-f7g8-h9i0-j1k2-l3m4n5o6p7q8"
]
​
created_at
string<date-time>

La marca de tiempo de cuándo se creó el grupo de notificación.

Example:

"2025-10-29T12:24:17.000Z"

​
updated_at
string<date-time>

La marca de tiempo de la última actualización del grupo de notificación.

Example:

"2025-10-29T12:28:00.000Z"