Historial de webhooks GET
Consulta el historial de las peticiones entrantes de un webhook concreto: qué se envió, qué se generó y si se entregó la alerta.
Endpoint
GET https://api.pocketalert.app/v1/webhooks/{tid}/historyAutenticación
Obligatorio
Incluye uno de estos encabezados en tu petición:
Token: <your-api-key>— Obtenla en Claves de APIAuthorization: Bearer <jwt-token>— Desde Iniciar sesión
Petición
Parámetros de ruta
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
tid | string | ✅ | Identificador único del webhook |
Parámetros de consulta
| Parámetro | Tipo | Por defecto | Descripción |
|---|---|---|---|
page | integer | 1 | Número de página |
per | integer | 50 | Elementos por página (máximo 200) |
status | string | — | Filtra por resultado: success o error |
Ejemplo de petición
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())Respuesta
Respuesta correcta
200 OK
Devuelve una lista paginada de peticiones, de la más reciente a la más antigua
| Campo | Tipo | Descripción |
|---|---|---|
requests | array | Peticiones registradas |
total | integer | Total de peticiones dentro del periodo de retención |
page | integer | Página actual |
per | integer | Elementos por página |
retention_days | integer | Cuántos días de historial conserva tu plan (0 = ilimitado) |
webhook | object | tid, name, url, is_active |
Cada elemento de requests:
| Campo | Tipo | Descripción |
|---|---|---|
id | integer | Identificador de la petición |
method | string | Método HTTP usado por el emisor |
source_ip | string | Dirección IP del emisor |
content_type | string | Tipo de contenido de la petición |
query | string | Cadena de consulta sin procesar |
headers | object | Encabezados de la petición (los sensibles se ocultan) |
body | string | Payload de la petición |
size | integer | Tamaño del payload en bytes |
status | string | success o error |
error_code | string | Motivo del fallo; vacío si fue correcta |
rendered_message | string | Mensaje generado a partir de tu plantilla |
message_tid | string | Identificador del mensaje creado; vacío si falló |
priority | integer | Nivel de alerta resultante |
duration_ms | integer | Tiempo de procesamiento |
created_at | string | Momento en que llegó la petición |
{
"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
}
}Códigos de error
Cuando status es error, error_code explica qué ocurrió:
| Código | Significado |
|---|---|
inactive | El webhook está desactivado, así que no se envió ninguna alerta |
invalid_json | El payload no se pudo interpretar como JSON |
empty_message | La plantilla dio como resultado una cadena vacía; normalmente, un %path% que no existe en el payload |
encryption_failed | No se pudo cifrar el mensaje |
save_failed | No se pudo guardar el mensaje |
daily_limit | Se alcanzó el límite diario de mensajes de la cuenta. La llamada recibió 429 y no se envió ninguna alerta; el payload y el mensaje generado se conservan aquí |
Respuestas de error
| Estado | Descripción |
|---|---|
401 | No autorizado — token no válido o ausente |
404 | No encontrado — el webhook no existe |
Notas
Retención
El historial se conserva durante un número limitado de días según tu plan (ver retention_days): 7 días en Free, 30 en Starter, 90 en Medium y 365 en Large. Las peticiones antiguas se eliminan automáticamente, al igual que las entradas más antiguas cuando un mismo webhook supera las 1.000 llamadas registradas.
Privacidad
Los payloads se cifran en reposo con tu clave personal, del mismo modo que el contenido de los mensajes. Los encabezados de autorización, cookies y claves de API se sustituyen por [redacted] antes de guardarse.