История вебхуков

Ваши вебхуки перестают быть чёрный ящик.

Каждый входящий вызов записывается вместе с заголовками, полезной нагрузкой, собранным сообщением и результатом. Если интеграция утверждает, что отправила запрос, вы можете проверить это.

Заголовки & payloadПонятные причины ошибокДо 1 годаОбновлено
Что вы получаете

Всё, о чём не расскажет неудачный вебхук

Когда уведомление не приходит, вопрос всегда один и тот же: отправитель вообще сделал вызов, а если сделал, что пошло не так на нашей стороне?

Журнал всех запросов

Каждый вызов записывается, новые сверху, раскрывается прямо в списке. Метод, IP-адрес отправителя, размер и тип содержимого видны сразу.

Заголовки и полезная нагрузка целиком

Полные заголовки и исходное тело запроса в том виде, в котором они пришли. Можно сравнить, что сервис заявляет, и что он реально отправил.

Что получилось из вашего шаблона

Смотрите сообщение, которое шаблон собрал из полезной нагрузки, рядом с самой полезной нагрузкой. Ошибки в шаблонах перестают быть догадками.

Понятные причины ошибок

Ошибки сопровождаются конкретной причиной: некорректный JSON, пустое сообщение из-за отсутствующего %path% или неактивный вебхук.

Скрытие и шифрование

Заголовки Authorization, cookie и с API-ключом редактируются до сохранения, а полезная нагрузка шифруется при хранении вашим ключом.

Фильтр, пагинация или выгрузка

Фильтруйте по результату и листайте историю на панели или загружайте её через API и анализируйте самостоятельно.

Быстрый старт

Узнайте, что пришло на самом деле

1

Укажите вебхук в сервисе

Создайте вебхук и укажите URL в настройках сервиса, как обычно.

2

Откройте историю

Откройте вебхук на панели и перейдите в его историю.

3

Разверните вызов

Разверните любой вызов, чтобы увидеть заголовки, тело, собранное сообщение и причину ошибки.

Как работает история вебхуков

Каждый запрос, пришедший на один из ваших URL вебхуков, записывается до обработки, а результат добавляется по её завершении. Поэтому неудачные вызовы видны так же ясно, как и успешные, включая вызовы на вебхук, который вы отключили и забыли.

Откройте вебхук на панели, и его история будет там: сначала новые записи. Каждая строка раскрывается и показывает строку запроса, все заголовки и тело с форматированием JSON. Те же данные доступны через REST API с фильтрами по success и error.

Отладка шаблона

Самая частая проблема связана не с сетью, а с плейсхолдером %path%, который указывает на поле, которое отправитель на самом деле не передаёт. История показывает исходную полезную нагрузку и сообщение из шаблона рядом, что обычно делает несоответствие очевидным за считанные секунды.

Конфиденциальность

Полезная нагрузка часто содержит секреты, поэтому она шифруется при хранении вашим персональным ключом, а заголовки Authorization, cookie и с API-ключом заменяются на [redacted] до сохранения. Срок хранения составляет от 7 дней на Free до года на Large.

FAQ

Ответы на вопросы

Время, HTTP-метод, IP-адрес отправителя, тип содержимого, строка запроса, все заголовки, исходное тело запроса, размер полезной нагрузки, сообщение, которое получилось из шаблона, создано ли уведомление, причина ошибки, если уведомление не создано, и время обработки.

7 дней на Free, 30 на Starter, 90 на Medium и 365 на Large. Старые вызовы удаляются автоматически, так же как и самые ранние записи, когда у одного вебхука накапливается более 1 000 записанных вызовов.

Да. Полезная нагрузка шифруется при хранении вашим персональным ключом, как и содержимое сообщений. Заголовки Authorization, cookie и с API-ключом заменяются на [redacted] до сохранения.

История покажет, в чём дело. Если вызовов в истории нет вообще, отправитель до нас не дошёл. Если вызов записан с ошибкой, вы увидите причину: некорректный JSON, пустое сообщение из-за того, что %path% отсутствует в полезной нагрузке, или вебхук был отключён.

Откройте вебхук на панели, и его история будет там: сначала новые записи, каждый вызов можно развернуть. Есть также REST-эндпоинт, если хотите получать данные программно, с фильтрами по успешным и неуспешным вызовам.

Да, с хранением за 7 дней. Если нужно дольше, это доступно на платных тарифах.

Перестаньте гадать, почему уведомление не пришло

Укажите сервису вебхук Pocket Alert, и каждый его вызов будет зафиксирован, независимо от того, дошло ли push-уведомление.