Add user mentions to API docs.

- Fixes #329
This commit is contained in:
Dessalines 2019-11-22 16:39:53 -08:00
parent 446e2da600
commit 547c72228f

98
docs/api.md vendored
View file

@ -28,100 +28,103 @@
+ [Get Replies / Inbox](#get-replies--inbox) + [Get Replies / Inbox](#get-replies--inbox)
- [Request](#request-4) - [Request](#request-4)
- [Response](#response-4) - [Response](#response-4)
+ [Mark all replies as read](#mark-all-replies-as-read) + [Get User Mentions](#get-user-mentions)
- [Request](#request-5) - [Request](#request-5)
- [Response](#response-5) - [Response](#response-5)
+ [Delete Account](#delete-account) + [Mark All As Read](#mark-all-as-read)
- [Request](#request-6) - [Request](#request-6)
- [Response](#response-6) - [Response](#response-6)
+ [Add admin](#add-admin) + [Delete Account](#delete-account)
- [Request](#request-7) - [Request](#request-7)
- [Response](#response-7) - [Response](#response-7)
+ [Ban user](#ban-user) + [Add admin](#add-admin)
- [Request](#request-8) - [Request](#request-8)
- [Response](#response-8) - [Response](#response-8)
* [Site](#site) + [Ban user](#ban-user)
+ [List Categories](#list-categories)
- [Request](#request-9) - [Request](#request-9)
- [Response](#response-9) - [Response](#response-9)
+ [Search](#search) * [Site](#site)
+ [List Categories](#list-categories)
- [Request](#request-10) - [Request](#request-10)
- [Response](#response-10) - [Response](#response-10)
+ [Get Modlog](#get-modlog) + [Search](#search)
- [Request](#request-11) - [Request](#request-11)
- [Response](#response-11) - [Response](#response-11)
+ [Create Site](#create-site) + [Get Modlog](#get-modlog)
- [Request](#request-12) - [Request](#request-12)
- [Response](#response-12) - [Response](#response-12)
+ [Edit Site](#edit-site) + [Create Site](#create-site)
- [Request](#request-13) - [Request](#request-13)
- [Response](#response-13) - [Response](#response-13)
+ [Get Site](#get-site) + [Edit Site](#edit-site)
- [Request](#request-14) - [Request](#request-14)
- [Response](#response-14) - [Response](#response-14)
+ [Transfer Site](#transfer-site) + [Get Site](#get-site)
- [Request](#request-15) - [Request](#request-15)
- [Response](#response-15) - [Response](#response-15)
* [Community](#community) + [Transfer Site](#transfer-site)
+ [Get Community](#get-community)
- [Request](#request-16) - [Request](#request-16)
- [Response](#response-16) - [Response](#response-16)
+ [Create Community](#create-community) * [Community](#community)
+ [Get Community](#get-community)
- [Request](#request-17) - [Request](#request-17)
- [Response](#response-17) - [Response](#response-17)
+ [List Communities](#list-communities) + [Create Community](#create-community)
- [Request](#request-18) - [Request](#request-18)
- [Response](#response-18) - [Response](#response-18)
+ [Ban from Community](#ban-from-community) + [List Communities](#list-communities)
- [Request](#request-19) - [Request](#request-19)
- [Response](#response-19) - [Response](#response-19)
+ [Add Mod to Community](#add-mod-to-community) + [Ban from Community](#ban-from-community)
- [Request](#request-20) - [Request](#request-20)
- [Response](#response-20) - [Response](#response-20)
+ [Edit Community](#edit-community) + [Add Mod to Community](#add-mod-to-community)
- [Request](#request-21) - [Request](#request-21)
- [Response](#response-21) - [Response](#response-21)
+ [Follow Community](#follow-community) + [Edit Community](#edit-community)
- [Request](#request-22) - [Request](#request-22)
- [Response](#response-22) - [Response](#response-22)
+ [Get Followed Communities](#get-followed-communities) + [Follow Community](#follow-community)
- [Request](#request-23) - [Request](#request-23)
- [Response](#response-23) - [Response](#response-23)
+ [Transfer Community](#transfer-community) + [Get Followed Communities](#get-followed-communities)
- [Request](#request-24) - [Request](#request-24)
- [Response](#response-24) - [Response](#response-24)
* [Post](#post) + [Transfer Community](#transfer-community)
+ [Create Post](#create-post)
- [Request](#request-25) - [Request](#request-25)
- [Response](#response-25) - [Response](#response-25)
+ [Get Post](#get-post) * [Post](#post)
+ [Create Post](#create-post)
- [Request](#request-26) - [Request](#request-26)
- [Response](#response-26) - [Response](#response-26)
+ [Get Posts](#get-posts) + [Get Post](#get-post)
- [Request](#request-27) - [Request](#request-27)
- [Response](#response-27) - [Response](#response-27)
+ [Create Post Like](#create-post-like) + [Get Posts](#get-posts)
- [Request](#request-28) - [Request](#request-28)
- [Response](#response-28) - [Response](#response-28)
+ [Edit Post](#edit-post) + [Create Post Like](#create-post-like)
- [Request](#request-29) - [Request](#request-29)
- [Response](#response-29) - [Response](#response-29)
+ [Save Post](#save-post) + [Edit Post](#edit-post)
- [Request](#request-30) - [Request](#request-30)
- [Response](#response-30) - [Response](#response-30)
* [Comment](#comment) + [Save Post](#save-post)
+ [Create Comment](#create-comment)
- [Request](#request-31) - [Request](#request-31)
- [Response](#response-31) - [Response](#response-31)
+ [Edit Comment](#edit-comment) * [Comment](#comment)
+ [Create Comment](#create-comment)
- [Request](#request-32) - [Request](#request-32)
- [Response](#response-32) - [Response](#response-32)
+ [Save Comment](#save-comment) + [Edit Comment](#edit-comment)
- [Request](#request-33) - [Request](#request-33)
- [Response](#response-33) - [Response](#response-33)
+ [Create Comment Like](#create-comment-like) + [Save Comment](#save-comment)
- [Request](#request-34) - [Request](#request-34)
- [Response](#response-34) - [Response](#response-34)
+ [Create Comment Like](#create-comment-like)
- [Request](#request-35)
- [Response](#response-35)
<!-- tocstop --> <!-- tocstop -->
@ -314,7 +317,32 @@ Only the first user will be able to be the admin.
} }
``` ```
#### Mark all replies as read #### Get User Mentions
##### Request
```rust
{
op: "GetUserMentions",
data: {
sort: String,
page: Option<i64>,
limit: Option<i64>,
unread_only: bool,
auth: String,
}
}
```
##### Response
```rust
{
op: String,
mentions: Vec<UserMentionView>,
}
```
#### Mark All As Read
Marks all user replies and mentions as read.
##### Request ##### Request
```rust ```rust
{ {