Fix for dropping posts/notifs in WS when mix task is executed
[akkoma] / docs / ap_extensions.md
index 7d2956d6d877d3b04fa24165320fa5874ff8dec1..3d1caeb3e7478ebdde29aeee323b2e256d9dea21 100644 (file)
@@ -3,12 +3,18 @@
 
 The following endpoints are additionally present into our actors.
 
-- `oauthRegistrationEndpoint`
-- `uploadMedia`
+- `oauthRegistrationEndpoint` (`http://litepub.social/ns#oauthRegistrationEndpoint`)
+- `uploadMedia` (`https://www.w3.org/ns/activitystreams#uploadMedia`)
+
+### oauthRegistrationEndpoint
+
+Points to MastodonAPI `/api/v1/apps` for now.
+
+See <https://docs.joinmastodon.org/methods/apps/>
 
 ### uploadMedia
 
-Inspired by <https://www.w3.org/wiki/SocialCG/ActivityPub/MediaUpload>
+Inspired by <https://www.w3.org/wiki/SocialCG/ActivityPub/MediaUpload>, it is part of the ActivityStreams namespace because it used to be part of the ActivityPub specification and got removed from it.
 
 Content-Type: multipart/form-data
 
@@ -22,12 +28,14 @@ The object given in the reponse should then be inserted into an Object's `attach
 
 ## ChatMessages
 
-ChatMessages are the messages sent in 1-on-1 chats. They are similar to
+`ChatMessage`s are the messages sent in 1-on-1 chats. They are similar to
 `Note`s, but the addresing is done by having a single AP actor in the `to`
 field. Addressing multiple actors is not allowed. These messages are always
 private, there is no public version of them. They are created with a `Create`
 activity.
 
+They are part of the `litepub` namespace as `http://litepub.social/ns#ChatMessage`.
+
 Example:
 
 ```json