Aller au contenu

Historique des webhooks GET ​

Récupérez l’historique des requêtes entrantes d’un webhook spécifique : ce qui a été envoyé, ce qui a été généré et si une alerte a été délivrée.

Point de terminaison ​

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

Authentification ​

Obligatoire

Incluez l’un de ces en-têtes dans votre requête :

  • Token: <your-api-key> — Obtenez-la depuis Clés API
  • Authorization: Bearer <jwt-token> — Depuis Connexion

Requête ​

Paramètres de chemin ​

ParamètreTypeObligatoireDescription
tidstring✅Identifiant unique du webhook

Paramètres de requête ​

ParamètreTypePar défautDescription
pageinteger1Numéro de page
perinteger50Éléments par page (maximum 200)
statusstring—Filtrer par résultat : success ou error

Exemple de requête ​

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

Réponse ​

Réponse en cas de succès ​

200 OK

Renvoie une liste paginée des requêtes, de la plus récente à la plus ancienne

ChampTypeDescription
requestsarrayRequêtes enregistrées
totalintegerNombre total de requêtes dans la période de conservation
pageintegerPage courante
perintegerÉléments par page
retention_daysintegerNombre de jours d’historique conservés par votre offre (0 = illimité)
webhookobjecttid, name, url, is_active

Chaque élément de requests :

ChampTypeDescription
idintegerIdentifiant de la requête
methodstringMéthode HTTP utilisée par l’expéditeur
source_ipstringAdresse IP de l’appelant
content_typestringType de contenu de la requête
querystringChaîne de requête brute
headersobjectEn-têtes de la requête (les données sensibles sont masquées)
bodystringContenu de la requête
sizeintegerTaille du contenu en octets
statusstringsuccess ou error
error_codestringRaison de l’échec, vide en cas de succès
rendered_messagestringMessage généré à partir de votre modèle
message_tidstringIdentifiant du message créé, vide en cas d’échec
priorityintegerNiveau d’alerte retenu
duration_msintegerDurée de traitement
created_atstringDate de réception de la requête
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
  }
}

Codes d’erreur ​

Lorsque status vaut error, error_code explique ce qui s’est passé :

CodeSignification
inactiveLe webhook est désactivé, aucune alerte n’a donc été envoyée
invalid_jsonLe contenu n’a pas pu être analysé comme du JSON
empty_messageLe modèle a donné une chaîne vide — généralement un %path% absent du contenu
encryption_failedLe message n’a pas pu être chiffré
save_failedLe message n’a pas pu être enregistré
daily_limitLa limite quotidienne de messages du compte a été atteinte. L’appel a reçu un 429 et aucune alerte n’a été envoyée ; le contenu et le message généré sont conservés ici

Réponses d’erreur ​

StatutDescription
401Non autorisé — Jeton invalide ou absent
404Introuvable — Le webhook n’existe pas

Remarques ​

Conservation

L’historique est conservé pendant un nombre limité de jours selon votre offre (voir retention_days) : 7 jours sur l’offre gratuite, 30 sur Starter, 90 sur Medium et 365 sur Large. Les requêtes plus anciennes sont supprimées automatiquement, de même que les entrées les plus anciennes dès qu’un webhook dépasse 1 000 appels enregistrés.

Confidentialité

Les contenus sont chiffrés au repos avec votre clé personnelle, de la même manière que le contenu des messages. Les en-têtes Authorization, cookie et clé API sont remplacés par [redacted] avant le stockage.

Documentation de Pocket Alert