访问统计 | CWD 评论系统文档

页面访问统计接口，用于记录和分析页面访问数据。

记录页面访问

POST /api/analytics/visit

前端组件在加载时调用此接口，记录页面访问数据，用于后台访问统计分析。

请求头

名称	必填	示例
`Content-Type`	是	`application/json`

请求体

{
  "postSlug": "https://example.com/blog/hello-world",
  "postTitle": "博客标题",
  "postUrl": "https://example.com/blog/hello-world"
}

请求头

名称	必填	示例
`Content-Type`	是	`application/json`
`X-Site-Id`	否	`blog`

字段说明：

字段名	类型	必填	说明
`postSlug`	string	是	文章唯一标识符，`window.location.origin + window.location.pathname`
`postTitle`	string	否	文章标题，用于后台展示页面名称
`postUrl`	string	否	文章 URL，用于后台展示页面链接和域名统计

请求头说明：

名称	必填	说明
`X-Site-Id`	否	站点 ID，用于多站点数据隔离，默认 `default`

成功响应

{
  "success": true
}

错误响应

服务器内部错误：

{
  "message": "记录访问数据失败"
}

GET /api/analytics/pv

获取指定页面的访问量（PV），用于在前端展示页面访问次数。

查询参数

名称	位置	类型	必填	说明
`post_slug`	query	string	是	文章唯一标识符
`siteId`	query	string	否	站点 ID，用于多站点数据隔离，默认 `default`

成功响应

{
  "pv": 100,
  "postSlug": "https://example.com/blog/hello-world"
}

字段说明：

字段名	类型	说明
`pv`	number	页面访问量（PV）
`postSlug`	string	文章唯一标识符

错误响应

缺少 post_slug：

{
  "message": "post_slug is required"
}

服务器内部错误：

{
  "message": "获取访问量失败"
}