Быстрый старт

Обзор

Alert4Me принимает structured CloudEvents через HTTP, сохраняет событие, применяет правила и доставляет уведомление в Telegram, Max или Webhook. Ingestion API возвращает 202 Accepted после сохранения и постановки доставки в очередь, не дожидаясь ответа внешнего провайдера.

Перед началом

Нужны аккаунт Alert4Me, команда, API-ключ и хотя бы один канал доставки.

• Создайте API-ключ в dashboard и сохраните его один раз.
• Подключите Telegram, Max или Webhook-канал.
• Для примеров используйте переменную окружения ALERT4ME_API_KEY.

Отправьте первое событие

Минимальный structured CloudEvent содержит specversion, source, type и data. Если id, time или datacontenttype не переданы, Alert4Me нормализует их на стороне API.

curl -i https://api.alert4me.ru/v1/events \
  -H "Authorization: Bearer $ALERT4ME_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "specversion": "1.0",
    "source": "billing",
    "type": "invoice.paid",
    "data": {
      "title": "Оплачен счет",
      "description": "Клиент оплатил счет на 4900 руб."
    }
  }'

Проверьте ответ

Успешный ответ означает, что событие принято и доставка будет обработана асинхронно. Поле duplicate показывает идемпотентный повтор того же события.

HTTP/1.1 202 Accepted
Content-Type: application/json

{
  "event": {
    "id": "evt_01jz...",
    "cloud_event_id": "sha256-...",
    "source": "billing",
    "type": "invoice.paid",
    "received_at": "2026-06-25T12:00:00Z"
  },
  "duplicate": false
}

Что дальше

После первого события создайте правило по source и type, выберите канал и проверьте журнал доставок в dashboard.