# 获取点赞状态

```
GET /api/like
```

获取当前页面的点赞状态和总点赞数，一般由前端组件在页面加载时自动调用。

- 方法：`GET`
- 路径：`/api/like`
- 鉴权：不需要

**查询参数**

| 名称        | 位置  | 类型   | 必填 | 说明                                                |
| ----------- | ----- | ------ | ---- | --------------------------------------------------- |
| `post_slug` | query | string | 是   | 页面唯一标识符，`window.location.origin + window.location.pathname` |

**请求头（可选）**

| 名称              | 必填 | 示例                          | 说明                           |
| ----------------- | ---- | ----------------------------- | ------------------------------ |
| `X-CWD-Like-User` | 否   | `550e8400-e29b-41d4-a716...` | 前端生成的匿名用户标识，用于区分不同用户 |

未显式传入 `X-CWD-Like-User` 时，服务端会尝试使用 `cf-connecting-ip` 作为用户标识，找不到时退回到 `anonymous`。

**成功响应**

- 状态码：`200`

```json
{
  "liked": false,
  "alreadyLiked": false,
  "totalLikes": 12
}
```

字段说明：

| 字段名        | 类型    | 说明                                     |
| ------------- | ------- | ---------------------------------------- |
| `liked`       | boolean | 当前用户是否已点赞                       |
| `alreadyLiked` | boolean | 预留字段，当前实现始终为 `false`        |
| `totalLikes`  | number  | 当前页面的总点赞数                       |

**错误响应**

- 缺少 `post_slug`：

  - 状态码：`400`

  ```json
  {
    "message": "post_slug is required"
  }
  ```

- 服务器内部错误：

  - 状态码：`500`

  ```json
  {
    "message": "获取点赞状态失败"
  }
  ```