Перейти к содержимому

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

Получите историю входящих запросов к конкретному вебхуку: что было отправлено, что получилось после подстановки шаблона и было ли доставлено push-уведомление.

Эндпоинт ​

GET https://api.pocketalert.app/v1/webhooks/{tid}/history

Аутентификация ​

Обязательно

Добавьте в запрос один из этих заголовков:

Запрос ​

Параметры пути ​

ПараметрТипОбязательныйОписание
tidstring✅Уникальный идентификатор вебхука

Параметры запроса ​

ПараметрТипПо умолчаниюОписание
pageinteger1Номер страницы
perinteger50Количество элементов на странице (максимум 200)
statusstring—Фильтр по результату: success или error

Пример запроса ​

bash
curl -X GET "https://api.pocketalert.app/v1/webhooks/kblf7mh9j8jjyeh4fx/history?per=25&status=error" \
  -H "Token: your-api-key"
javascript
const tid = 'kblf7mh9j8jjyeh4fx';
const response = await fetch(`https://api.pocketalert.app/v1/webhooks/${tid}/history?per=25`, {
  headers: { 'Token': 'your-api-key' }
});
const history = await response.json();
python
import requests

tid = 'kblf7mh9j8jjyeh4fx'
response = requests.get(
    f'https://api.pocketalert.app/v1/webhooks/{tid}/history',
    headers={'Token': 'your-api-key'},
    params={'per': 25, 'status': 'error'}
)
print(response.json())

Ответ ​

Успешный ответ ​

200 OK

Возвращает постраничный список запросов, сначала самые новые

ПолеТипОписание
requestsarrayСохранённые запросы
totalintegerОбщее количество запросов в пределах срока хранения
pageintegerТекущая страница
perintegerКоличество элементов на странице
retention_daysintegerСколько дней хранится история на вашем тарифе (0 = без ограничений)
webhookobjecttid, name, url, is_active

Каждый элемент в requests:

ПолеТипОписание
idintegerИдентификатор запроса
methodstringHTTP-метод, использованный отправителем
source_ipstringIP-адрес отправителя
content_typestringТип содержимого запроса
querystringИсходная строка запроса
headersobjectЗаголовки запроса (чувствительные скрыты)
bodystringСодержимое запроса
sizeintegerРазмер содержимого в байтах
statusstringsuccess или error
error_codestringПричина ошибки, пусто при успехе
rendered_messagestringСообщение, созданное по вашему шаблону
message_tidstringИдентификатор созданного сообщения, пусто при ошибке
priorityintegerИтоговый уровень важности уведомления
duration_msintegerВремя обработки
created_atstringКогда пришёл запрос
json
{
  "requests": [
    {
      "id": 412,
      "method": "POST",
      "source_ip": "140.82.115.16",
      "content_type": "application/json",
      "query": "",
      "headers": { "User-Agent": "GitHub-Hookshot", "Authorization": "[redacted]" },
      "body": "{\"repository\":{\"name\":\"pocketalert\"}}",
      "size": 38,
      "status": "success",
      "error_code": "",
      "rendered_message": "Push to pocketalert",
      "message_tid": "yrst1db64dbbe7euurpmanhdy",
      "priority": 1,
      "duration_ms": 24,
      "created_at": "18.07.2026 16:45:06"
    }
  ],
  "total": 1,
  "page": 1,
  "per": 50,
  "retention_days": 90,
  "webhook": {
    "tid": "kblf7mh9j8jjyeh4fx",
    "name": "GitHub Push",
    "url": "cs994rqfkk8ljngt",
    "is_active": true
  }
}

Коды ошибок ​

Если status равен error, поле error_code объясняет, что произошло:

КодЗначение
inactiveВебхук отключён, поэтому уведомление не отправлено
invalid_jsonСодержимое не удалось разобрать как JSON
empty_messageШаблон дал пустую строку — обычно это %path%, которого нет в содержимом
encryption_failedНе удалось зашифровать сообщение
save_failedНе удалось сохранить сообщение
daily_limitДостигнут дневной лимит сообщений аккаунта. Вызов получил 429, уведомление не отправлено; содержимое и итоговое сообщение сохранены здесь

Ошибки ответа ​

СтатусОписание
401Unauthorized — токен неверный или отсутствует
404Not Found — вебхук не существует

Примечания ​

Срок хранения

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

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

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

Документация Pocket Alert