mirrors/pleroma
1
0
Fork 0
mirror of https://git.pleroma.social/pleroma/pleroma.git synced 2024-05-21 19:18:06 +00:00
Code Issues Projects Releases Wiki Activity

Fix docs wording

Browse source
This commit is contained in:
tusooa 2023-04-01 02:37:19 -04:00
parent 9572be1e5f
commit 7f12ad6dcc
No known key found for this signature in database
GPG key ID: 42AEC43D48433C51
1 changed files with 9 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

18
docs/development/API/differences_in_mastoapi_responses.md
View file

@ -421,7 +421,7 @@ The value of the attribute is an array containing one or two elements. The first
For the following stream types, there is a second element in the array:
- `list`: The second element is the id of the list.
- `list`: The second element is the id of the list, as a string.
- `hashtag`: The second element is the name of the hashtag.
- `public:remote:media` and `public:remote`: The second element is the domain of the corresponding instance.
@ -429,11 +429,11 @@ For all other stream types, there is no second element.
Some examples of valid `stream` values:
- `list:1`: List of id 1.
- `hashtag:mew`: The hashtag #mew.
- `user:notifications`: Notifications for the current user.
- `user`: Home timeline.
- `public:remote:mew.moe`: Public posts from the instance mew.moe .
- `["list", "1"]`: List of id 1.
- `["hashtag", "mew"]`: The hashtag #mew.
- `["user:notifications"]`: Notifications for the current user.
- `["user"]`: Home timeline.
- `["public:remote", "mew.moe"]`: Public posts from the instance mew.moe .
### The unified streaming endpoint
@ -447,7 +447,7 @@ To subscribe to a stream after the connection is established, merge the JSON obj
For example, to receive updates on the list 1, you can connect to `/api/v1/streaming/?stream=list&list=1`, or send
```
{"type": "subscribe", "stream": "list", "list": 1}
{"type": "subscribe", "stream": "list", "list": "1"}
```
upon establishing the websocket connection.
@ -455,14 +455,14 @@ upon establishing the websocket connection.
To unsubscribe to list 1, send
```
{"type": "unsubscribe", "stream": "list", "list": 1}
{"type": "unsubscribe", "stream": "list", "list": "1"}
```
Note that if you specify a stream that requires a logged-in user in the query string (for example, `user` or `list`), you have to specify the access token when you are trying to establish the connection, i.e. in the query string or via the `sec-websocket-protocol` header.
- `list`
- Query style: `?stream=list&list=<id>`
- Subscribe style: `{"stream": "list", "list": <id>}`
- Subscribe style: `{"stream": "list", "list": "<id>"}`
- `public`, `public:local`, `public:media`, `public:local:media`, `user`, `user:pleroma_chat`, `user:notifications`, `direct`
- Query style: `?stream=<stream name>`
- Subscribe style: `{"stream": "<stream name>"}`