Créer un abonnement webhook

Abonne une URL https aux évènements du flux des annonces (genres et filtres au choix), à la fin des opérations asynchrones de l'organisation, et aux résultats des veilles et des alertes que l'organisation a créées par l'API (livrés 15 minutes au moins après leur remontée, au format de resultats_veilles). Chaque livraison est un POST JSON signé par l'en-tête Pillr-Signature (t=horodatage, v1=HMAC-SHA256 du texte « horodatage.corps » avec le secret de l'abonnement), reprise à 1 min, 5 min, 30 min, 2 h et 12 h en cas d'échec ; l'abonnement est coupé après 50 échecs consécutifs. Le secret n'est affiché qu'à la création. Chaque évènement d'annonce et chaque résultat livré est débité au barème evenement (1 crédit). Coût : 0 crédit par appel réussi.

post/webhooks

Request

  • Base URL: https://pillr.fr/api/v1
  • URL: https://pillr.fr/api/v1/webhooks
  • Auth: HTTP bearer

Request body

urlstring required

URL https publique qui recevra les livraisons.

genresstring[] required

Les genres suivis.

Response

Ressource créée.

secretstring required

Secret de signature de cet abonnement, affiché cette seule fois : gardez-le pour vérifier l'en-tête Pillr-Signature.

signaturestring required

Comment vérifier une livraison, en clair.

Changes

No recorded changes to this operation across all 1 revision of this API.