snac2

commit a136f7533d223865adec2a0794b9c290be631290
parent 955b591a74399d48d54d52ac8899e3e70d369939
Author: grunfink <grunfink@comam.es>
Date:   Sun,  1 Jun 2025 17:07:23 +0200

Updated documentation.

Diffstat:
M
doc/snac.1
 | 
19
++++++++++++++++---

1 file changed, 16 insertions(+), 3 deletions(-)
diff --git 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