文章和评论点赞相关的公开接口。
获取点赞状态
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
{
"liked": false,
"alreadyLiked": false,
"totalLikes": 12
}字段说明：
| 字段名 | 类型 | 说明 |
|---|---|---|
liked |
boolean | 当前用户是否已点赞 |
alreadyLiked |
boolean | 预留字段，当前实现始终为 false |
totalLikes |
number | 当前页面的总点赞数 |
错误响应
-
缺少
post_slug：- 状态码：
400
{ "message": "post_slug is required" } - 状态码：
-
服务器内部错误：
- 状态码：
500
{ "message": "获取点赞状态失败" } - 状态码：
点赞文章
POST /api/like对当前页面执行点赞操作，同一用户对同一页面只会计入一次点赞。
- 方法：
POST - 路径：
/api/like - 鉴权：不需要
请求头
| 名称 | 必填 | 示例 | 说明 |
|---|---|---|---|
ContentC-Type |
是 | application/json |
|
X-CWD-Like-User |
否 | 550e8400-e29b-41d4-a716... |
前端生成的匿名用户标识，用于区分不同用户 |
请求体
{
"postSlug": "https://example.com/blog/hello-world",
"postTitle": "博客标题，可选",
"postUrl": "https://example.com/blog/hello-world"
}字段说明：
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
postSlug |
string | 是 | 页面唯一标识符，应与评论接口中的 post_slug 一致 |
postTitle |
string | 否 | 页面标题，用于点赞统计中显示 |
postUrl |
string | 否 | 页面 URL，用于点赞统计中跳转 |
成功响应
- 状态码：
200
{
"liked": true,
"alreadyLiked": false,
"totalLikes": 13
}说明：
- 第一次点赞：
liked=true，alreadyLiked=false，totalLikes增加 1； - 重复点赞：服务器不会重复插入记录，
alreadyLiked=true，totalLikes不会继续增加。
错误响应
-
缺少
postSlug：- 状态码：
400
{ "message": "postSlug is required" } - 状态码：
-
服务器内部错误：
- 状态码：
500
{ "message": "点赞失败" } - 状态码：
评论
评论加载中…