История вебхука GET
Получите историю входящих запросов к конкретному вебхуку: что было отправлено, что получилось после подстановки шаблона и было ли доставлено push-уведомление.
Эндпоинт
GET https://api.pocketalert.app/v1/webhooks/{tid}/historyАутентификация
Обязательно
Добавьте в запрос один из этих заголовков:
Token: <your-api-key>— получить можно в разделе API-ключиAuthorization: Bearer <jwt-token>— из метода входа
Запрос
Параметры пути
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
tid | string | ✅ | Уникальный идентификатор вебхука |
Параметры запроса
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
page | integer | 1 | Номер страницы |
per | integer | 50 | Количество элементов на странице (максимум 200) |
status | string | — | Фильтр по результату: success или error |
Пример запроса
curl -X GET "https://api.pocketalert.app/v1/webhooks/kblf7mh9j8jjyeh4fx/history?per=25&status=error" \
-H "Token: your-api-key"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();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
Возвращает постраничный список запросов, сначала самые новые
| Поле | Тип | Описание |
|---|---|---|
requests | array | Сохранённые запросы |
total | integer | Общее количество запросов в пределах срока хранения |
page | integer | Текущая страница |
per | integer | Количество элементов на странице |
retention_days | integer | Сколько дней хранится история на вашем тарифе (0 = без ограничений) |
webhook | object | tid, name, url, is_active |
Каждый элемент в requests:
| Поле | Тип | Описание |
|---|---|---|
id | integer | Идентификатор запроса |
method | string | HTTP-метод, использованный отправителем |
source_ip | string | IP-адрес отправителя |
content_type | string | Тип содержимого запроса |
query | string | Исходная строка запроса |
headers | object | Заголовки запроса (чувствительные скрыты) |
body | string | Содержимое запроса |
size | integer | Размер содержимого в байтах |
status | string | success или error |
error_code | string | Причина ошибки, пусто при успехе |
rendered_message | string | Сообщение, созданное по вашему шаблону |
message_tid | string | Идентификатор созданного сообщения, пусто при ошибке |
priority | integer | Итоговый уровень важности уведомления |
duration_ms | integer | Время обработки |
created_at | string | Когда пришёл запрос |
{
"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, уведомление не отправлено; содержимое и итоговое сообщение сохранены здесь |
Ошибки ответа
| Статус | Описание |
|---|---|
401 | Unauthorized — токен неверный или отсутствует |
404 | Not Found — вебхук не существует |
Примечания
Срок хранения
История хранится ограниченное количество дней в зависимости от тарифа (см. retention_days): 7 дней на бесплатном тарифе, 30 на Starter, 90 на Medium и 365 на Large. Старые запросы удаляются автоматически, так же как самые старые записи, когда у одного вебхука накапливается больше 1 000 записанных вызовов.
Конфиденциальность
Содержимое запросов шифруется при хранении вашим персональным ключом — так же, как и содержимое сообщений. Заголовки Authorization, cookie и API-ключей заменяются на [redacted] до сохранения.