home
prev
next
rand

一、文章列表

GET /api/posts
参数类型描述备注
pageint当前页可选
pageSizeint分页数可选
filterTypestringcategory 或 tag 或 search可选
filterSlugstring分类名或标签名或搜索关键字可选
showContentbool是否显示文章具体内容可选

二、页面列表

GET /api/pages

三、分类列表

GET /api/categories

四、标签列表

GET /api/tags

五、文章/页面详情

GET /api/post
参数类型描述备注
cidint文章/页面 ID二选一
slugstring文章/页面别名二选一

六、评论列表

GET /api/comments
参数类型描述备注
pageint当前页可选
pageSizeint分页数可选
orderstring评论显示顺序(asc/desc)可选
cidint文章 ID二选一
slugstring文章别名二选一

七、最近评论

GET /api/recentComments
参数类型描述备注
sizeint最近评论的条数,默认为 9可选

八、发表评论

GET /api/comment
参数类型描述备注
cidint文章 ID二选一
slugstring文章别名二选一
parentint父级评论 ID可选
textstring评论内容必须
authorstring作者必须
mailstring邮箱必须
urlstringURL可选
tokenstring文章/页面详情返回的 token必须
uidint已注册用户评论时,用户的 UID可选
authCodestring已注册用户评论时,用户的 authCode可选
PS:此处Content-Type为application/json, 也就是说你应当以 JSON 格式提交数据。

PS2: uid 和 authCode 可以在 Cookie 中找到(形如 hash__typecho_uid 和 hash__typecho_authCode 的内容)。带上 Cookie 请求此 API 则不再需要带上 uid 和 authCode 参数。请求时需要带上合法的 User-Agent.

九、设置项

GET /api/settings

十、用户信息

GET /api/users
参数类型描述备注
uidint用户 ID可选
namestring用户名或昵称可选

十一、归档

GET /api/settings
参数类型描述备注
showContentbool是否显示文章内容可选
orderstring归档的排序方式 (asc / desc)可选
Top