> ## Documentation Index
> Fetch the complete documentation index at: https://docs.2024921.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# 文章

> 文章 CRUD 接口

## 获取文章列表

```http theme={null}
GET /api/posts
```

**查询参数：**

| 参数         | 类型       | 说明                    |
| ---------- | -------- | --------------------- |
| `page`     | `number` | 页码                    |
| `pageSize` | `number` | 每页数量                  |
| `category` | `string` | 分类筛选                  |
| `tag`      | `string` | 标签筛选                  |
| `search`   | `string` | 搜索                    |
| `status`   | `string` | `published` / `draft` |

**响应示例：**

```json theme={null}
{
  "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
}
```

## 获取单篇文章

```http theme={null}
GET /api/posts/:id
```

**响应示例：**

```json theme={null}
{
  "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"
  }
}
```

<Info>
  加密文章的 `enc` 字段包含 `{salt, iv, data}`，`content` 为空。前端使用用户密码解密。
</Info>

## 创建文章

```http theme={null}
POST /api/posts
Authorization: Bearer <token>
```

**请求体：**

```json theme={null}
{
  "title": "文章标题",
  "content": "Markdown 正文",
  "excerpt": "摘要",
  "cover": "封面图 URL",
  "tags": ["标签1"],
  "category": "分类",
  "pinned": false,
  "protected": false,
  "password": "加密密码",
  "status": "published"
}
```

**响应：**

```json theme={null}
{
  "ok": true,
  "id": "article-slug"
}
```

## 更新 / 删除

```http theme={null}
PUT    /api/posts/:id     # 更新（请求体同创建，只传需更新的字段）
DELETE /api/posts/:id     # 删除
```

都需要认证。