获取文章列表
GET /api/posts
| 参数 | 类型 | 说明 |
|---|---|---|
page | number | 页码 |
pageSize | number | 每页数量 |
category | string | 分类筛选 |
tag | string | 标签筛选 |
search | string | 搜索 |
status | string | published / draft |
{
"ok": true,
"posts": [
{
"id": "article-slug",
"title": "文章标题",
"date": "2025-01-01",
"excerpt": "摘要...",
"cover": "https://...",
"pinned": 0,
"protected": 0,
"tags": ["标签1", "标签2"],
"category": "分类",
"status": "published"
}
],
"total": 42,
"page": 1,
"pageSize": 5
}
获取单篇文章
GET /api/posts/:id
{
"ok": true,
"post": {
"id": "article-slug",
"title": "文章标题",
"content": "Markdown 正文...",
"enc": null,
"tags": ["标签1"],
"category": "分类",
"status": "published",
"created_at": "2025-01-01T00:00:00Z",
"updated_at": "2025-01-01T00:00:00Z"
}
}
加密文章的
enc 字段包含 {salt, iv, data}，content 为空。前端使用用户密码解密。创建文章
POST /api/posts
Authorization: Bearer <token>
{
"title": "文章标题",
"content": "Markdown 正文",
"excerpt": "摘要",
"cover": "封面图 URL",
"tags": ["标签1"],
"category": "分类",
"pinned": false,
"protected": false,
"password": "加密密码",
"status": "published"
}
{
"ok": true,
"id": "article-slug"
}
更新 / 删除
PUT /api/posts/:id # 更新（请求体同创建，只传需更新的字段）
DELETE /api/posts/:id # 删除