API

留言 API

留言列表

取得某篇文章對應的留言列表

GET /api/comment

參數：

欄位	型別	描述
path	string	取得對應文章識別碼的留言列表
page	number	留言列表的頁數
pageSize	number	每頁留言列表的筆數
sortBy	string	留言排序方式，預設依時間倒序（insertedAt_desc），也可以選擇依時間正序（insertedAt_asc）、依熱度倒序（like_desc）

留言數

取得某篇文章對應的留言總數

GET /api/comment?type=count

參數：

欄位	型別	描述
url	string	取得對應文章識別碼的留言列表，若為空會傳回全站留言數

最近留言

取得目前網站的最近留言

GET /api/comment?type=recent

參數：

欄位	型別	描述
count	number	傳回最新留言的筆數

發表留言

發表一則留言

POST /api/comment

參數：

欄位	型別	描述
comment	string	留言內容
link	string	使用者輸入的網站
mail	string	使用者輸入的電子郵件
nick	string	使用者輸入的暱稱
pid	string	該則留言回覆的留言 objectId
rid	string	該則留言的根留言 objectId
ua	string	使用者的 user agent
url	string	留言的文章識別碼
at	string	該則留言回覆的留言作者暱稱

閱讀統計 API

取得閱讀統計數

取得某篇文章或多篇文章對應的閱讀數

GET /api/article

參數：

欄位	型別	描述
path	string	對應文章識別碼，多個識別碼以逗號串接

更新閱讀統計數

更新某篇文章的閱讀數

POST /api/article

參數：

欄位	型別	描述
path	string	對應文章識別碼