Уведомления

Обновление подписки · бесплатно

💳 Стоимость: бесплатно

Обновляет URL получателя уведомлений и/или статус активности подписки. При повторном включении подписки сбрасываются счётчики ошибок и доставка возобновляется на следующем тике.

patch/v1/callback/subscriptions/{subscription_id}

Request

  • Base URL: https://maxstat.ru/api
  • URL: https://maxstat.ru/api/v1/callback/subscriptions/{subscription_id}
  • Auth: API key in header X-API-Token

Path parameters

subscription_idstring uuid required

Идентификатор подписки на уведомления.

Example:9f3f0c8a-7d52-4f42-a8b1-5a9b7a7f6a10

Request body

callback_urlstring uri nullable

Новый публично доступный HTTPS URL получателя уведомлений.

activeboolean nullable

Статус подписки. Неактивные подписки не обрабатываются. При установке true сбрасываются счётчики ошибок.

Example request

{
  "callback_url": "https://example.com/maxstat/webhooks-v2",
  "active": true
}

Response

Successful Response

idstring uuid required

Идентификатор подписки.

type'channel' | 'keyword' required

Тип подписки: channel для канала или keyword для поискового запроса.

activeboolean

Признак активности подписки. Неактивные подписки не обрабатываются.

callback_urlstring required

URL, на который отправляются уведомления по подписке.

channel_idstring nullable

Идентификатор отслеживаемого канала. Заполняется только для подписок типа channel.

querystring nullable

Поисковый запрос. Заполняется только для подписок типа keyword.

category_idinteger nullable

Идентификатор категории канала для подписки типа keyword, если фильтр задан.

last_processed_atstring date-time nullable

Дата и время, до которых MaxStat проверил новые публикации по этой подписке.

last_matched_atstring date-time nullable

Дата и время последней отправки уведомления с найденными публикациями.

last_error_atstring date-time nullable

Дата и время последней ошибки при отправке уведомления.

last_error_typestring nullable

Имя класса исключения последней ошибки доставки, например ConnectError или HTTPStatusError.

consecutive_failuresinteger

Количество последовательных ошибок доставки. При достижении порога подписка автоматически деактивируется.

created_atstring date-time required

Дата и время создания подписки.

updated_atstring date-time required

Дата и время последнего обновления подписки.

Example response

{
  "id": "9f3f0c8a-7d52-4f42-a8b1-5a9b7a7f6a10",
  "type": "channel",
  "active": true,
  "callback_url": "https://example.com/maxstat/webhooks",
  "channel_id": "-91827364546372",
  "query": "запуск продукта",
  "category_id": 12,
  "last_processed_at": "2026-05-05T10:15:00+03:00",
  "last_matched_at": "2026-05-05T10:15:00+03:00",
  "last_error_at": "2026-05-05T10:15:00+03:00",
  "last_error_type": "ConnectError",
  "created_at": "2026-05-05T09:00:00+03:00",
  "updated_at": "2026-05-05T10:15:00+03:00"
}

Changes

No recorded changes to this operation across all 1 revision of this API.