REST API — Statnive 文档

身份验证

Statnive 的 REST API 使用标准的 WordPress REST 身份验证。您可以使用应用程序密码、基于 Cookie 的身份验证（针对已登录用户），或任何与 WordPress REST API 集成的身份验证插件进行认证。所有端点默认要求 manage_options 权限。

基础 URL

所有端点均注册于 statnive/v1 命名空间下：

https://yoursite.com/wp-json/statnive/v1/

可用端点

GET /stats/summary

返回指定日期范围内关键指标的摘要。

参数：

from（字符串，必填）—— 起始日期，格式为 YYYY-MM-DD。
to（字符串，必填）—— 结束日期，格式为 YYYY-MM-DD。

响应：

{
  "visitors": 1234,
  "pageviews": 3456,
  "sources": { "organic_search": 520, "social": 310, "direct": 280 },
  "top_pages": [{ "path": "/", "views": 890 }]
}

GET /stats/sources

按渠道返回流量来源细分。

GET /stats/pages

返回按页面浏览量排序的页面级分析数据。

GET /stats/realtime

返回当前活跃访客数和最近的页面浏览动态。

速率限制

API 请求被限制为每位已认证用户每分钟最多 60 次。该限制在应用层强制执行，超出后将返回 429 Too Many Requests 响应。