Deployka
ВойтиНачать
Вся документация
Python

Webhook Receiver

Стартовый FastAPI endpoint для входящих HTTP-вебхуков. Он проверяет общий секрет в заголовке X-Webhook-Secret и подтверждает запрос, но пока не обрабатывает событие и не проверяет подпись конкретного сервиса.

  1. 1

    Зарегистрируйтесь на Deployka

    Если у вас ещё нет аккаунта — создайте его за 30 секунд: email и пароль.

    Создать аккаунт →
  2. 2

    Подготовьте нужные ключи/переменные

    Для этого шаблона нужно заполнить одну переменную: SECRET_KEY. Вот как их получить — шаг за шагом.

    SECRET_KEY
    1. Это общий секрет вашего стартового endpoint, а не токен от внешнего сервиса и не подпись провайдера.
    2. Шаблон ждёт его в заголовке X-Webhook-Secret. Используйте случайную строку минимум из 20 символов.
    3. Если провайдер поддерживает только собственную HMAC-подпись, потребуется добавить проверку его официальной схемы.

    Не вставляйте этот секрет в URL: URL может попасть в логи и историю запросов.

  3. 3

    Запустите деплой

    Нажмите кнопку ниже — откроется страница шаблонов с уже выбранным этим шаблоном. Если он требует переменные — вставьте значения, полученные на шаге выше, и нажмите Deploy.

    Задеплоить «Webhook Receiver»

    Деплой обычно занимает 20–40 секунд. Статус проекта появится в личном кабинете и сменится на «running», когда всё готово.

  4. 4

    Проверьте, что всё работает

    После деплоя отправьте POST на https://адрес-проекта.deployka.dev/webhook с заголовком X-Webhook-Secret, равным SECRET_KEY. Верный секрет должен дать HTTP 200, неверный или отсутствующий — HTTP 401.

    1. Укажите /webhook как адрес endpoint и настройте отправку заголовка X-Webhook-Secret со значением SECRET_KEY.
    2. Сначала проверьте запрос вручную: правильный заголовок должен вернуть 200, неправильный — 401.
    3. Заготовка только подтверждает получение. Перед обработкой реальных платежей или команд добавьте проверку подписи провайдера, защиту от повторной доставки и свою логику обработки.

    Некоторые сервисы не умеют отправлять произвольный общий заголовок и используют HMAC-подпись. Для них эту проверку нужно заменить или дополнить кодом по официальной документации сервиса.

  5. 5

    Что-то не работает?

    Откройте страницу проекта в личном кабинете → вкладка Logs — там видна точная причина (неверный токен, ошибка в коде, отсутствующая переменная). Если не разобрались — напишите в поддержку прямо из личного кабинета или через Telegram-бота командой /support.

Ищете другой шаблон? Смотрите полный список в документации.