احراز هویت

REST API در Statnive از احراز هویت استاندارد WordPress REST استفاده می‌کند. می‌توانید با application passwords، احراز هویت مبتنی بر cookie (برای کاربران واردشده) یا هر plugin احراز هویتی که با WordPress REST API یکپارچه می‌شود، احراز هویت کنید. تمام endpointها به‌صورت پیش‌فرض به دسترسی manage_options نیاز دارند.

URL پایه

تمام endpointها در فضای نام statnive/v1 ثبت شده‌اند:

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

endpointهای موجود

GET /stats/summary

خلاصه‌ای از معیارهای کلیدی برای یک بازه زمانی مشخص بازمی‌گرداند.

پارامترها:

• from (string، الزامی) — تاریخ شروع در قالب YYYY-MM-DD.
• to (string، الزامی) — تاریخ پایان در قالب 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 بازمی‌گرداند.