Zum Inhalt springen

Webhook-Verlauf GET ​

Ruf den Verlauf der eingehenden Anfragen an einen bestimmten Webhook ab — was gesendet wurde, was daraus gerendert wurde und ob eine Benachrichtigung zugestellt wurde.

Endpunkt ​

GET https://api.pocketalert.app/v1/webhooks/{tid}/history

Authentifizierung ​

Erforderlich

Füge einen dieser Header in deiner Anfrage hinzu:

Anfrage ​

Pfadparameter ​

ParameterTypPflichtBeschreibung
tidstring✅Eindeutige ID des Webhooks

Abfrageparameter ​

ParameterTypStandardBeschreibung
pageinteger1Seitennummer
perinteger50Einträge pro Seite (maximal 200)
statusstring—Nach Ergebnis filtern: success oder error

Beispielanfrage ​

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

Antwort ​

Erfolgreiche Antwort ​

200 OK

Gibt eine paginierte Liste der Anfragen zurück, neueste zuerst

FeldTypBeschreibung
requestsarrayGespeicherte Anfragen
totalintegerGesamtzahl der Anfragen innerhalb des Aufbewahrungszeitraums
pageintegerAktuelle Seite
perintegerEinträge pro Seite
retention_daysintegerWie viele Tage Verlauf dein Tarif speichert (0 = unbegrenzt)
webhookobjecttid, name, url, is_active

Jeder Eintrag in requests:

FeldTypBeschreibung
idintegerID der Anfrage
methodstringHTTP-Methode des Absenders
source_ipstringIP-Adresse des Aufrufers
content_typestringContent-Type der Anfrage
querystringRoher Query-String
headersobjectAnfrage-Header (sensible werden geschwärzt)
bodystringNutzlast der Anfrage
sizeintegerGröße der Nutzlast in Bytes
statusstringsuccess oder error
error_codestringFehlerursache, bei Erfolg leer
rendered_messagestringNachricht, die aus deiner Vorlage entstanden ist
message_tidstringID der erstellten Nachricht, bei Fehlschlag leer
priorityintegerErmittelte Warnstufe
duration_msintegerVerarbeitungszeit
created_atstringZeitpunkt, zu dem die Anfrage eingegangen ist
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
  }
}

Fehlercodes ​

Wenn status den Wert error hat, erklärt error_code, was passiert ist:

CodeBedeutung
inactiveDer Webhook ist deaktiviert, daher wurde keine Benachrichtigung gesendet
invalid_jsonDie Nutzlast konnte nicht als JSON gelesen werden
empty_messageDie Vorlage ergab einen leeren String — meist ein %path%, der in der Nutzlast nicht existiert
encryption_failedDie Nachricht konnte nicht verschlüsselt werden
save_failedDie Nachricht konnte nicht gespeichert werden
daily_limitDas Tageslimit für Nachrichten des Kontos wurde erreicht. Der Aufruf erhielt 429 und es wurde keine Benachrichtigung gesendet; Nutzlast und gerenderte Nachricht werden hier trotzdem aufbewahrt

Fehlerantworten ​

StatusBeschreibung
401Nicht autorisiert — Token ungültig oder fehlt
404Nicht gefunden — Webhook existiert nicht

Hinweise ​

Aufbewahrung

Der Verlauf wird je nach Tarif für eine begrenzte Anzahl von Tagen gespeichert (siehe retention_days): 7 Tage im kostenlosen Tarif, 30 im Starter, 90 im Medium und 365 im Large. Ältere Anfragen werden automatisch entfernt, ebenso die ältesten Einträge, sobald ein einzelner Webhook mehr als 1.000 aufgezeichnete Aufrufe hat.

Datenschutz

Nutzlasten werden im Ruhezustand mit deinem persönlichen Schlüssel verschlüsselt, genauso wie Nachrichteninhalte. Authorization-, Cookie- und API-Schlüssel-Header werden vor der Speicherung durch [redacted] ersetzt.

Pocket Alert Dokumentation