Cronologia webhook GET
Recupera la cronologia delle richieste in arrivo a un webhook specifico: cosa è stato inviato, cosa è stato generato e se la notifica è stata consegnata.
Endpoint
GET https://api.pocketalert.app/v1/webhooks/{tid}/historyAutenticazione
Obbligatoria
Includi una di queste intestazioni nella tua richiesta:
Token: <your-api-key>— Ottienila da Chiavi APIAuthorization: Bearer <jwt-token>— Da Accedi
Richiesta
Parametri di percorso
| Parametro | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
tid | string | ✅ | Identificatore univoco del webhook |
Parametri di query
| Parametro | Tipo | Predefinito | Descrizione |
|---|---|---|---|
page | integer | 1 | Numero di pagina |
per | integer | 50 | Elementi per pagina (massimo 200) |
status | string | — | Filtra per esito: success o error |
Esempio di richiesta
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())Risposta
Risposta di successo
200 OK
Restituisce un elenco paginato di richieste, dalla più recente
| Campo | Tipo | Descrizione |
|---|---|---|
requests | array | Richieste registrate |
total | integer | Numero totale di richieste nella finestra di conservazione |
page | integer | Pagina corrente |
per | integer | Elementi per pagina |
retention_days | integer | Quanti giorni di cronologia conserva il tuo piano (0 = illimitati) |
webhook | object | tid, name, url, is_active |
Ogni elemento di requests:
| Campo | Tipo | Descrizione |
|---|---|---|
id | integer | Identificatore della richiesta |
method | string | Metodo HTTP usato dal mittente |
source_ip | string | Indirizzo IP del chiamante |
content_type | string | Tipo di contenuto della richiesta |
query | string | Query string grezza |
headers | object | Intestazioni della richiesta (quelle sensibili sono oscurate) |
body | string | Payload della richiesta |
size | integer | Dimensione del payload in byte |
status | string | success o error |
error_code | string | Motivo del fallimento, vuoto in caso di successo |
rendered_message | string | Messaggio prodotto dal tuo template |
message_tid | string | Identificatore della notifica creata, vuoto in caso di errore |
priority | integer | Livello di allerta risolto |
duration_ms | integer | Tempo di elaborazione |
created_at | string | Momento in cui la richiesta è arrivata |
{
"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
}
}Codici di errore
Quando status è error, error_code spiega cosa è successo:
| Codice | Significato |
|---|---|
inactive | Il webhook è disattivato, quindi non è stata inviata alcuna notifica |
invalid_json | Il payload non può essere interpretato come JSON |
empty_message | Il template ha prodotto una stringa vuota — di solito un %path% che non esiste nel payload |
encryption_failed | Non è stato possibile cifrare la notifica |
save_failed | Non è stato possibile salvare la notifica |
daily_limit | È stato raggiunto il limite giornaliero di messaggi dell'account. La chiamata ha ricevuto 429 e non è stata inviata alcuna notifica; il payload e il messaggio generato vengono comunque conservati qui |
Risposte di errore
| Stato | Descrizione |
|---|---|
401 | Non autorizzato — token non valido o mancante |
404 | Non trovato — il webhook non esiste |
Note
Conservazione
La cronologia viene conservata per un numero limitato di giorni in base al tuo piano (vedi retention_days): 7 giorni nel piano gratuito, 30 in Starter, 90 in Medium e 365 in Large. Le richieste più vecchie vengono rimosse automaticamente, così come le voci meno recenti quando un singolo webhook supera 1.000 chiamate registrate.
Privacy
I payload sono cifrati a riposo con la tua chiave personale, allo stesso modo del contenuto dei messaggi. Le intestazioni Authorization, cookie e chiavi API vengono sostituite con [redacted] prima dell'archiviazione.