From a136f7533d223865adec2a0794b9c290be631290 Mon Sep 17 00:00:00 2001 From: grunfink Date: Sun, 1 Jun 2025 17:07:23 +0200 Subject: Updated documentation. --- doc/snac.1 | 19 ++++++++++++++++--- 1 file changed, 16 insertions(+), 3 deletions(-) diff --git a/doc/snac.1 b/doc/snac.1 index 5fcb0c6..d4e9af7 100644 --- a/doc/snac.1 +++ b/doc/snac.1 @@ -417,11 +417,24 @@ https://$SNAC_HOST/oauth/x-snac-get-token .Ss Webhook for notifications Since version 2.78, users can set the URL to a webhook that will receive an HTTP POST with every notification (in JSON format). This can be used to -implement some automation whenever a new activity happens, like autorepliers -or chatbots or whatever. The +implement some automation whenever a new activity happens, like autorepliers, +chatbots, interactive textual games or whatever. The .Pa examples/ subdirectory contains a tiny Python program that implements an auto-follower -for every new follow. +for every new follow. The JSON notification object includes the following data: +.Bd -literal -offset indent +id: a unique notification identifier +actor: the origin actor id +target: the target actor id +date: the notification date +message: the full ActivityPub action JSON object +objid: the object identifier (extracted from message, may be null) +type: the action type (extracted from message) +utype: the action subtype (extracted from message, may be null) +uid: the user identifier (account name) +basedir: the server base directory +baseurl: the server base URL +.Ed .Pp .Sh ENVIRONMENT .Bl -tag -width Ds -- cgit v1.2.3