Vai al contenuto

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

Autenticazione ​

Obbligatoria

Includi una di queste intestazioni nella tua richiesta:

  • Token: <your-api-key> — Ottienila da Chiavi API
  • Authorization: Bearer <jwt-token> — Da Accedi

Richiesta ​

Parametri di percorso ​

ParametroTipoObbligatorioDescrizione
tidstring✅Identificatore univoco del webhook

Parametri di query ​

ParametroTipoPredefinitoDescrizione
pageinteger1Numero di pagina
perinteger50Elementi per pagina (massimo 200)
statusstring—Filtra per esito: success o error

Esempio di richiesta ​

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

Risposta ​

Risposta di successo ​

200 OK

Restituisce un elenco paginato di richieste, dalla più recente

CampoTipoDescrizione
requestsarrayRichieste registrate
totalintegerNumero totale di richieste nella finestra di conservazione
pageintegerPagina corrente
perintegerElementi per pagina
retention_daysintegerQuanti giorni di cronologia conserva il tuo piano (0 = illimitati)
webhookobjecttid, name, url, is_active

Ogni elemento di requests:

CampoTipoDescrizione
idintegerIdentificatore della richiesta
methodstringMetodo HTTP usato dal mittente
source_ipstringIndirizzo IP del chiamante
content_typestringTipo di contenuto della richiesta
querystringQuery string grezza
headersobjectIntestazioni della richiesta (quelle sensibili sono oscurate)
bodystringPayload della richiesta
sizeintegerDimensione del payload in byte
statusstringsuccess o error
error_codestringMotivo del fallimento, vuoto in caso di successo
rendered_messagestringMessaggio prodotto dal tuo template
message_tidstringIdentificatore della notifica creata, vuoto in caso di errore
priorityintegerLivello di allerta risolto
duration_msintegerTempo di elaborazione
created_atstringMomento in cui la richiesta è arrivata
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
  }
}

Codici di errore ​

Quando status è error, error_code spiega cosa è successo:

CodiceSignificato
inactiveIl webhook è disattivato, quindi non è stata inviata alcuna notifica
invalid_jsonIl payload non può essere interpretato come JSON
empty_messageIl template ha prodotto una stringa vuota — di solito un %path% che non esiste nel payload
encryption_failedNon è stato possibile cifrare la notifica
save_failedNon è 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 ​

StatoDescrizione
401Non autorizzato — token non valido o mancante
404Non 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.

Documentazione di Pocket Alert