git.squeep.com Git - akkoma/blob - docs/docs/development/ap_extensions.md

   1 # AP Extensions
   2 ## Actor endpoints
   3
   4 The following endpoints are additionally present into our actors.
   5
   6 - `oauthRegistrationEndpoint` (`http://litepub.social/ns#oauthRegistrationEndpoint`)
   7 - `uploadMedia` (`https://www.w3.org/ns/activitystreams#uploadMedia`)
   8
   9 ### oauthRegistrationEndpoint
  10
  11 Points to MastodonAPI `/api/v1/apps` for now.
  12
  13 See <https://docs.joinmastodon.org/methods/apps/>
  14
  15 ### uploadMedia
  16
  17 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.
  18
  19 Content-Type: multipart/form-data
  20
  21 Parameters:
  22 - (required) `file`: The file being uploaded
  23 - (optionnal) `description`: A plain-text description of the media, for accessibility purposes.
  24
  25 Response: HTTP 201 Created with the object into the body, no `Location` header provided as it doesn't have an `id`
  26
  27 The object given in the reponse should then be inserted into an Object's `attachment` field.
  28