1. Найти калькулятор
  2. Ввод чисел и единиц
  3. Как читать результат и доверять ему
  4. Сохранить, поделиться и встроить
  5. Разработка с API
  6. Аккаунт и тариф
  7. Конфиденциальность и ваши данные
  8. Решить проблему

Проверка подписи вебхука

Составьте строку t.body из заголовка X-CalcLib-Signature, вычислите HMAC-SHA256 с вашим секретом и сравните результат, прежде чем обрабатывать доставку.

API-токены, использование, MCP-сервер для ИИ-агентов и вебхуки.

Конечная точка вебхука, добавленная в разделе Вебхуки, получает подписанный POST-запрос каждый раз, когда кто-то запускает ваш встраиваемый калькулятор. В каждой доставке есть заголовок X-CalcLib-Signature вида t=<unix time>,v1=<signature>.

Проверяйте до разбора

  1. Прочитайте необработанное тело запроса. Если разобрать JSON и сериализовать его заново, байты изменятся, и подпись никогда не совпадёт.
  2. Возьмите t из заголовка и составьте строку t.body: метка времени, точка, затем необработанное тело.
  3. Вычислите HMAC-SHA256 этой строки с секретом вашей конечной точки в шестнадцатеричном виде.
  4. Сравните результат с каждым значением v1 за постоянное время. Пока вы меняете секрет, в заголовке могут быть два значения v1; совпасть может любое из них.
  5. Отклоняйте доставку, если t отличается от времени на ваших часах более чем на 5 минут.

Доставки с ошибкой

Мы повторяем их через 1 минуту, 5 минут, 30 минут, 2 часа и 8 часов. Конечная точка, которая выдаёт ошибку 20 раз подряд, отключается, и мы отправляем вам письмо — оно подчиняется переключателю для продуктовых писем в разделе Уведомления.

Была ли статья полезной?

Всё ещё не разобрались? Написать в поддержку · Справочный центр