Saltar al contenido

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}/history

Autenticación ​

Obligatorio

Incluye uno de estos encabezados en tu petición:

Petición ​

Parámetros de ruta ​

ParámetroTipoObligatorioDescripción
tidstring✅Identificador único del webhook

Parámetros de consulta ​

ParámetroTipoPor defectoDescripción
pageinteger1Número de página
perinteger50Elementos por página (máximo 200)
statusstring—Filtra por resultado: success o error

Ejemplo de petición ​

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())

Respuesta ​

Respuesta correcta ​

200 OK

Devuelve una lista paginada de peticiones, de la más reciente a la más antigua

CampoTipoDescripción
requestsarrayPeticiones registradas
totalintegerTotal de peticiones dentro del periodo de retención
pageintegerPágina actual
perintegerElementos por página
retention_daysintegerCuántos días de historial conserva tu plan (0 = ilimitado)
webhookobjecttid, name, url, is_active

Cada elemento de requests:

CampoTipoDescripción
idintegerIdentificador de la petición
methodstringMétodo HTTP usado por el emisor
source_ipstringDirección IP del emisor
content_typestringTipo de contenido de la petición
querystringCadena de consulta sin procesar
headersobjectEncabezados de la petición (los sensibles se ocultan)
bodystringPayload de la petición
sizeintegerTamaño del payload en bytes
statusstringsuccess o error
error_codestringMotivo del fallo; vacío si fue correcta
rendered_messagestringMensaje generado a partir de tu plantilla
message_tidstringIdentificador del mensaje creado; vacío si falló
priorityintegerNivel de alerta resultante
duration_msintegerTiempo de procesamiento
created_atstringMomento en que llegó la petición
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
  }
}

Códigos de error ​

Cuando status es error, error_code explica qué ocurrió:

CódigoSignificado
inactiveEl webhook está desactivado, así que no se envió ninguna alerta
invalid_jsonEl payload no se pudo interpretar como JSON
empty_messageLa plantilla dio como resultado una cadena vacía; normalmente, un %path% que no existe en el payload
encryption_failedNo se pudo cifrar el mensaje
save_failedNo se pudo guardar el mensaje
daily_limitSe 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 ​

EstadoDescripción
401No autorizado — token no válido o ausente
404No 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.

Documentación de Pocket Alert