Перейти к основному содержанию
POST
Создаёт новый секрет для подписи вебхука. Старый секрет продолжает подписывать запросы 24 часа, до previous_secret_expires_at. Повторная ротация в течение этого времени сразу отключает самый старый секрет.
Требуется scope webhooks_manage.

Запрос

Параметры пути

string
обязательно
Идентификатор вебхука (UUID).

Параметры тела запроса

Тело запроса необязательно.
boolean
по умолчанию:"false"
true сразу отключает текущий секрет, например после утечки.

Ответ

При успехе API возвращает 200 OK с вебхуком и его новым секретом.
string
обязательно
Секрет подписи: whsec_ и строка в base64. Aniva показывает его только в этом ответе. См. Проверка подписи.
string
обязательно
Идентификатор вебхука (UUID).
string
обязательно
HTTPS URL, на который Aniva отправляет события.
string
Произвольный текст для твоих заметок. Может быть null.
string[]
обязательно
Типы событий, которые получает этот вебхук. * означает все типы.
string[]
обязательно
Адреса, на которые Aniva отправляет письма, если доставки продолжают завершаться ошибкой.
string
обязательно
enabled или disabled.
string
Момент отключения вебхука в формате ISO 8601 (UTC). null, пока он включён.
string
Причина отключения вебхука. См. Уведомления о сбоях. null, пока он включён.
string
Момент начала текущей серии ошибок в формате ISO 8601 (UTC). null, если последняя доставка прошла успешно.
string
Момент в формате ISO 8601 (UTC), когда предыдущий секрет перестаёт использоваться для подписи. null, если ротация не выполняется.
string
обязательно
Момент создания вебхука в формате ISO 8601 (UTC).
string
обязательно
Момент последнего изменения в формате ISO 8601 (UTC).

Ответы с ошибками