{
"id": "evt_01jz8x3m4n5p6q7r8s9t0v1w2x",
"type": "api_key.expiring",
"created_at": "2026-11-04T10:00:00.000Z",
"workspace_id": "ws_01jz8x3m4n5p6q7r8s9t0v1w2x",
"company_id": "co_01jz8x3m4n5p6q7r8s9t0v1w2x",
"data": {
"key_id": "key_01jz8x3m4n5p6q7r8s9t0v1w2x",
"prefix": "tg_ab12cd34ef56",
"expires_at": "2026-11-18T10:00:00.000Z",
"days_left": 14
}
}Api keyexpiring
Срок ключа API скоро кончится: за 14 и за 3 дня (настройка платформы api_keys.expiry_reminder_days), по одному разу на порог. Продлить — PATCH ключа с expires_at или смена секрета (roll). Автору ключа уходит и письмо.
Подпись: заголовки webhook-id, webhook-timestamp, webhook-signature — Standard Webhooks. Проверка: 1) подписанная строка — «webhook-id.webhook-timestamp.тело», тело — байты запроса как пришли, до разбора JSON; 2) ключ — часть секрета после whsec_, раскодированная из base64; 3) HMAC-SHA256 от строки этим ключом, в base64; 4) в webhook-signature одна или несколько подписей через пробел, каждая вида «v1,base64» (при смене секрета сутки приходят две) — должна совпасть хотя бы одна, сравнивать постоянным по времени сравнением; 5) webhook-timestamp — секунды Unix; расхождение с вашими часами больше 5 минут — отклонить. Готовая проверка: new Webhook(secret).verify(rawBody, headers) из npm standardwebhooks.
Доставка: POST JSON на адрес. Успех — любой ответ 2xx за 30 секунд. Иначе — повторы через 5 с, 5 мин, 30 мин, 2 ч, 5 ч, 10 ч, 10 ч, 10 ч, 10 ч, 10 ч, 10 ч, 5 ч: всего 13 попыток, окно 72 ч 35 мин 5 с от первой до последней. После этого событие можно отправить снова вручную (POST …/webhooks/messages//resend). Адрес, который не принимает ничего 5 суток подряд, отключается (enabled: false) — включите его PATCH …/endpoints/ после починки. Доставка «хотя бы раз»: одно событие может прийти дважды — отбрасывайте повторы по id (evt_…), он у повтора тот же. Порядок не гарантируется: события могут прийти не в той последовательности, в какой случились, — сверяйте created_at и читайте актуальное состояние через API. В месячное число бесплатных событий тарифа считаются только события, которые есть кому получить (включённый адрес с подходящим фильтром); сверх него события не отправляются (не копятся и потом не досылаются): сколько не ушло — over_limit в GET …/webhooks/usage.
{
"id": "evt_01jz8x3m4n5p6q7r8s9t0v1w2x",
"type": "api_key.expiring",
"created_at": "2026-11-04T10:00:00.000Z",
"workspace_id": "ws_01jz8x3m4n5p6q7r8s9t0v1w2x",
"company_id": "co_01jz8x3m4n5p6q7r8s9t0v1w2x",
"data": {
"key_id": "key_01jz8x3m4n5p6q7r8s9t0v1w2x",
"prefix": "tg_ab12cd34ef56",
"expires_at": "2026-11-18T10:00:00.000Z",
"days_left": 14
}
}Заголовки
id сообщения (msg_…): один на все попытки доставки этого сообщения; входит в подписанную строку
"msg_2xyzExample"
Время этой попытки, секунды Unix; входит в подписанную строку
"1793974568"
Подписи через пробел, каждая вида v1,base64 (порядок проверки — в описании события)
"v1,kD9WhUZS+K/OigYAsDOosIiagX7cTfjEkMl9fxCJ4GI="
Тело
Срок ключа API скоро кончится: за 14 и за 3 дня (настройка платформы api_keys.expiry_reminder_days), по одному разу на порог. Продлить — PATCH ключа с expires_at или смена секрета (roll). Автору ключа уходит и письмо.
id события — тот же при повторной доставке: по нему отбрасывайте повторы (evt_…)
^evt_[0-9a-z]{26}$Вид события
api_key.expiring Когда событие случилось
Организация (ws_…)
^ws_[0-9a-z]{26}$Компания; null — событие организации (например, оплата) (co_…)
^co_[0-9a-z]{26}$Данные события — только id, суммы, токены, статусы и время, без персональных данных
Show child attributes
Show child attributes
Ответ
Любой ответ 2xx — событие доставлено. Иной ответ или нет ответа за 30 секунд — повтор по расписанию