Differences

This shows you the differences between two versions of the page.

--- extension:poke [2025/03/22 15:31] – created winter
+++ extension:poke [2025/03/24 19:09] (current) – why these verbs winter
@@ Line 12: / Line 12: @@
 </code>
-Another actor can now send an [[:authentication|authenticated]] POST request (using the [[:X-PawPub-Actor]] header) to the listed endpoint with JSON content following this schema:
+Another actor can now send an [[:authentication|authenticated]] POST request (using the [[:X-PawPub-Actor]] header) to the listed endpoint with ''application/x-www-form-urlencoded'' form content, with ''verb'' set to one of the allowed verbs (or by default "poke" if not specified) and ''urgent'' either set or not set.((The exact value of ''urgent'' doesn't matter, but it would be sensible to set it to something like ''1'' or ''true''. Receiving instances should not check its value, only whether it was present at all.))
-  * verb: "poke" | "bite" | "punch" | "kick" | "wave" | "yell" | "hug" | "kiss" | "pet" optional default="poke"
+The allowed verbs are:
-  * urgent: boolean optional default=false
+  * poke
+  * bite
+  * punch
+  * kick
+  * wave
+  * yell
+  * hug
+  * kiss
+  * pet
-For example:
+<WRAP center round todo 60%>
+why these verbs specifically? are there any others we could add?
+</WRAP>
-<code javascript>
-{
-    "verb": "yell",
+===== Example =====
-    "urgent": true
-}
+<code http>
+POST /actor/132/poke HTTP/1.1
+Host: antisocial.example
+Authorization: Bearer ...
+X-PawPub-Actor: https://social.example/actor/1
+Content-Type: application/x-www-form-urlencoded
+verb=yell&urgent=1
 </code>
-which would show the receiving actor a notification along the lines of "[user] yelled at you urgently" and possibly also indicate that the notification has urgent priority if the user's system allows.
+This would show the receiving actor a notification along the lines of "[user] yelled at you urgently" and possibly also indicate that the notification has urgent priority if the user's system allows.