aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorgrunfink <grunfink@comam.es>2025-06-01 17:07:23 +0200
committergrunfink <grunfink@comam.es>2025-06-01 17:07:23 +0200
commita136f7533d223865adec2a0794b9c290be631290 (patch)
tree537302213763bb9ee85f2bff8d24528ca33646ea /doc
parent955b591a74399d48d54d52ac8899e3e70d369939 (diff)
Updated documentation.
Diffstat (limited to 'doc')
-rw-r--r--doc/snac.119
1 files 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