Зачем вебхук
Опрос API тоже работает, но вебхук доставляет каждое SMS за секунды, и вашему коду не нужно спрашивать снова и снова.
Настройка
Откройте страницу «API-ключ», введите HTTPS-адрес на публичном домене и сохраните. Секрет подписи показывается один раз: храните его вместе с другими секретами сервера.
Что вы получите
POST-запрос с телом JSON: событие sms.received и data с id аренды, номером телефона, отправителем, полным текстом, найденным кодом и временем получения.
Проверяйте каждый запрос
Прочитайте заголовок X-PortSMS-Signature, вычислите HMAC-SHA256 от "t.body" с вашим секретом и сравните с v1 за постоянное время. Отклоняйте запросы, у которых t старше 5 минут.
Отвечайте быстро
Верните статус 2xx сразу после сохранения сообщения, а долгую обработку выполняйте потом. Любой другой ответ приводит к повтору, до 8 раз.