Platitun · API · Подписка на события · Заменить секрет подписи

Заменить секрет подписи

POST /api/v1/hooks/secret

Область ключа: hooks · изменяет данные, нужен заголовок Idempotency-Key

Новый секрет вместо прежнего, показ один раз. Прежний мёртв с этой секунды: проверка подписи на вашей стороне перестанет сходиться, пока новый секрет не окажется у неё.

Поля ответа

Поле	Тип	Что это
`secret`	`string`	Новый секрет — в первый и последний раз.

Поводы отказа

Отказ по правилам приходит как {"error":"rejected","refusal":{"kind":"…"}} с кодом 409. Общие для всех путей отказы — в разделе правил.

Код	Что случилось и что делать
`not_found`	Записи нет или она не ваша. Условие владения стоит в самом запросе к базе, поэтому чужая запись выглядит как отсутствующая.
`vault_off`	Сейф площадки не настроен, и хранить секреты негде. Это наша беда, а не ваша: напишите в поддержку.

Рядом в этом разделе

GET /api/v1/hooks — Своя подписка на события
PUT /api/v1/hooks — Задать адрес и события
DELETE /api/v1/hooks — Отключить доставку
POST /api/v1/hooks/resume — Включить доставку снова
POST /api/v1/hooks/test — Пробное событие
GET /api/v1/hooks/deliveries — Журнал доставки
POST /api/v1/hooks/probe — Выдать адрес служебного приёмника
GET /api/v1/hooks/probe — Что принял служебный приёмник