Читайте й приймайте сповіщення

Сповіщення — це один випадок, коли справдилося правило: бюджет перейшов свій поріг, пул втратив ємність, зросла кількість помилок. Операції цієї сторінки читають стрічку сповіщень і позначають сповіщення як переглянуте. Правила задають у консолі, на вкладці Правила екрана Сповіщення.

Як живе сповіщення

Slen перевіряє активні правила раз на хвилину.

• Коли правило справджується, відкривається сповіщення. occurred_at — цей момент.

• Поки правило виконується, сповіщення залишається одним сповіщенням. Його payload, severity і title оновлюються під час кожної перевірки, тому сповіщення, відкрите як warning, може стати critical.

• Коли правило перестає виконуватися, сповіщення закривається: з’являється resolved_at. Якщо правило призупинити або видалити, його відкрите сповіщення теж закривається. Вручну нічого закривати не потрібно.

Правило всієї організації перевіряється в кожному проєкті організації, і все одно в нього одне відкрите сповіщення за раз — про проєкт, де правило справдилося. Сповіщення залишається за цим проєктом, поки правило в ньому виконується. Коли цей проєкт повертається до норми, а інший усе ще в біді, сповіщення закривається і відкривається нове — про інший проєкт.

title — це речення англійською про те, що сталося, а payload несе числа, які за ним стоять.

Події вебхуків alert.opened і alert.resolved повідомляють про момент, коли сповіщення відкривається, і про момент, коли воно закривається. Оновлення відкритого сповіщення подій не надсилає.

Читання стрічки

Стрічка відповідає найновішими сповіщеннями на початку, не більше 100, і не ділиться на сторінки. Сповіщення називає проєкт, про який воно, у project_id — і тоді, коли його правило стежить за всією організацією. Ключ читає сповіщення про свій проєкт і сповіщення без проєкту, наприклад про бюджет або пул усієї організації.

Надішліть open=1, щоб прочитати лише незакриті сповіщення. Логічне значення в рядку запиту записується як 1 або 0, а open=true відхиляється з 422.

Прийняття сповіщення

Прийняти сповіщення — означає сказати, що його хтось побачив. Операція записує acknowledged_at і більше нічого не змінює: сповіщення залишається відкритим, поки його правило виконується, — або поки правило не призупинять чи не видалять. Повторне прийняття зберігає час першого.

acknowledged_by_user_id називає людину, яка прийняла сповіщення в консолі. Воно дорівнює null, коли це зробив API-ключ.

Сповіщення, якого не існує, або сповіщення іншого проєкту відповідає 404 з кодом alert_not_found.

Операції

{
  "data": [
    {
      "alert_id": "74438200973594624",
      "alert_rule_id": "74438200973594624",
      "project_id": "74438200973594624",
      "type": "budget_threshold",
      "severity": "warning",
      "title": "string",
      "payload": {},
      "occurred_at": "2026-10-02T09:30:00Z",
      "resolved_at": "2026-10-02T09:30:00Z",
      "acknowledged_at": "2026-10-02T09:30:00Z",
      "acknowledged_by_user_id": "74438200973594624"
    }
  ]
}

{
  "data": {
    "alert_id": "74438200973594624",
    "alert_rule_id": "74438200973594624",
    "project_id": "74438200973594624",
    "type": "budget_threshold",
    "severity": "warning",
    "title": "string",
    "payload": {},
    "occurred_at": "2026-10-02T09:30:00Z",
    "resolved_at": "2026-10-02T09:30:00Z",
    "acknowledged_at": "2026-10-02T09:30:00Z",
    "acknowledged_by_user_id": "74438200973594624"
  }
}

Приклади

Прочитати відкриті сповіщення

Відкрито одне сповіщення: місячний бюджет перейшов поріг свого правила.

curl "https://api.slen.ai/api/v1/alerts?open=1" \
  -H "Authorization: Bearer $SLEN_API_KEY"

{
  "data": [
    {
      "alert_id": "74441250346041344",
      "alert_rule_id": "74440612744429568",
      "project_id": "74438200973594624",
      "type": "budget_threshold",
      "severity": "warning",
      "title": "Monthly budget is 86.40% used",
      "payload": {
        "budget_id": "74437302811459584",
        "budget_name": "Production",
        "budget_type": "monthly",
        "currency": "USD",
        "limit": "500.00000000",
        "used": "432.00000000",
        "used_percent": "86.40",
        "threshold_percent": "80.00"
      },
      "occurred_at": "2026-10-02T07:12:00+00:00",
      "resolved_at": null,
      "acknowledged_at": null,
      "acknowledged_by_user_id": null
    }
  ]
}

Прийняти сповіщення

Відповідь — це сповіщення із записаним acknowledged_at. resolved_at досі дорівнює null: бюджет усе ще вищий за поріг.

curl -X POST https://api.slen.ai/api/v1/alerts/74441250346041344/ack \
  -H "Authorization: Bearer $SLEN_API_KEY"

{
  "data": {
    "alert_id": "74441250346041344",
    "alert_rule_id": "74440612744429568",
    "project_id": "74438200973594624",
    "type": "budget_threshold",
    "severity": "warning",
    "title": "Monthly budget is 86.40% used",
    "payload": {
      "budget_id": "74437302811459584",
      "budget_name": "Production",
      "budget_type": "monthly",
      "currency": "USD",
      "limit": "500.00000000",
      "used": "432.00000000",
      "used_percent": "86.40",
      "threshold_percent": "80.00"
    },
    "occurred_at": "2026-10-02T07:12:00+00:00",
    "resolved_at": null,
    "acknowledged_at": "2026-10-02T08:41:00+00:00",
    "acknowledged_by_user_id": null
  }
}

Що читати далі

• Сповіщення — правила та стрічка в консолі.

• Автентифікація — що доступно ключу в його проєкті та в його організації.

• Огляд — вигляд відповіді 422 для параметра, який не пройшов перевірку.

• Вебхуки — як приходять alert.opened і alert.resolved.