REST API — Statnive Docs

認証

Statnive の REST API は標準の WordPress REST 認証を使用します。アプリケーションパスワード、cookie ベースの認証 (ログイン中のユーザー向け)、または WordPress REST API と統合する任意の認証 plugin で認証できます。すべてのエンドポイントはデフォルトで manage_options 権限を必要とします。

ベース URL

すべてのエンドポイントは statnive/v1 名前空間の下に登録されます。

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

利用可能なエンドポイント

GET /stats/summary

指定された日付範囲における主要メトリクスのサマリーを返します。

パラメーター:

from (string, required) — 開始日 (YYYY-MM-DD 形式)。
to (string, required) — 終了日 (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 リクエストは、認証済みユーザーごとに 1 分あたり 60 リクエストにレート制限されています。この制限はアプリケーションレベルで適用され、上限を超えると 429 Too Many Requests レスポンスを返します。