Caleb Gardner
160 lines
2.4 KiB
Markdown
160 lines
2.4 KiB
Markdown
# Blog module
|
|
|
|
A simple blog module for darkstorm-backend.
|
|
|
|
## Requests
|
|
|
|
### Author info
|
|
|
|
#### Get author info
|
|
|
|
> GET /author/{authorID}
|
|
|
|
```json
|
|
{
|
|
id: "authorID",
|
|
name: "author name",
|
|
about: "about",
|
|
picurl: "picture URL"
|
|
}
|
|
```
|
|
|
|
#### Update author info
|
|
|
|
> POST /author/{authorID}
|
|
|
|
Must have a auth token for a user with the `"blog": "admin"` permission.
|
|
|
|
```json
|
|
{
|
|
name: "author name",
|
|
about: "about",
|
|
picurl: "picture url"
|
|
}
|
|
```
|
|
|
|
#### Add Author info
|
|
|
|
> POST /author
|
|
|
|
Must have a auth token for a user with the `"blog": "admin"` permission.
|
|
|
|
```json
|
|
{
|
|
name: "author name",
|
|
about: "about",
|
|
picurl: "picture URL"
|
|
}
|
|
```
|
|
|
|
### Blog
|
|
|
|
#### Specific blog
|
|
|
|
> GET /blog/{blogID}
|
|
|
|
Return:
|
|
|
|
```json
|
|
{
|
|
id: "blogID",
|
|
createTime: 0, // creation time in Unix format
|
|
updateTime: 0, // last update time in Unix format
|
|
author: "authorID",
|
|
favicon: "favicon url",
|
|
title: "blog title",
|
|
blog: "blog", // blog will have been converted to HTML
|
|
}
|
|
```
|
|
|
|
#### Create blog
|
|
|
|
Request:
|
|
|
|
> POST /blog
|
|
|
|
Must have a auth token for a user with the `"blog": "admin"` permission.
|
|
|
|
```json
|
|
{
|
|
favicon: "favicon url",
|
|
title: "blog title",
|
|
blog: "blog", // blog will have been converted to HTML
|
|
}
|
|
```
|
|
|
|
Return:
|
|
|
|
```json
|
|
{
|
|
id: "blogID"
|
|
}
|
|
```
|
|
|
|
#### Update blog
|
|
|
|
Request:
|
|
|
|
> POST /blog/{blogID}
|
|
|
|
Must have a auth token for a user with the `"blog": "admin"` permission.
|
|
|
|
```json
|
|
{
|
|
favicon: "new icon",
|
|
title: "new title",
|
|
blog: "new blog content"
|
|
}
|
|
```
|
|
|
|
#### Latest blogs
|
|
|
|
> GET /blog?page=0
|
|
|
|
Will return up to 5 blogs. `page` query is optional (implies 0 if not set).
|
|
|
|
Return:
|
|
|
|
```json
|
|
{
|
|
num: 1, // Number of returned results, returns up to 5 results
|
|
blogs: [
|
|
{
|
|
id: "blogID",
|
|
createTime: 0, // creation time in Unix format
|
|
updateTime: 0, // last update time in Unix format
|
|
author: "authorID",
|
|
favicon: "favicon url",
|
|
title: "blog title",
|
|
blog: "blog", // blog will have been converted to HTML
|
|
}
|
|
...
|
|
]
|
|
}
|
|
```
|
|
|
|
#### Blog List
|
|
|
|
> GET /blog/list?page=0
|
|
|
|
Will return up to 50 IDs. `page` query is optional (implies 0 if not set).
|
|
|
|
Return:
|
|
|
|
```json
|
|
{
|
|
num: 1, // Number of returned results, returns up to 50 results
|
|
blogList: [
|
|
{
|
|
id: "blogID",
|
|
createTime: 0, // Unix format
|
|
},
|
|
{
|
|
id: "blogID",
|
|
createTime: 0, // Unix format
|
|
},
|
|
...
|
|
]
|
|
}
|
|
```
|