نظرة عامة على التحليلات

curl --request GET \
  --url 'https://api.scanova.io/analytics/overview/?type=all_time,current_month,last_months,scan_dates' \
  --header 'Authorization: YOUR_API_KEY'

{
  "all_time": { "total_scans": 18420, "total_qr_codes": 96 },
  "current_month": { "total_scans": 1204, "unique_scans": 980 },
  "last_months": [["2026-06", 3120], ["2026-07", 4410], ["2026-08", 3980]],
  "scan_dates": [["2026-09-01", 42], ["2026-09-02", 51]]
}

GET

analytics

overview

curl --request GET \
  --url 'https://api.scanova.io/analytics/overview/?type=all_time,current_month,last_months,scan_dates' \
  --header 'Authorization: YOUR_API_KEY'

{
  "all_time": { "total_scans": 18420, "total_qr_codes": 96 },
  "current_month": { "total_scans": 1204, "unique_scans": 980 },
  "last_months": [["2026-06", 3120], ["2026-07", 4410], ["2026-08", 3980]],
  "scan_dates": [["2026-09-01", 42], ["2026-09-02", 51]]
}

يعيد تجميعًا لتحليلات المسح على مستوى الحساب بأكمله — عبر جميع رموز QR الخاصة بالحساب، دون الاقتصار على مورد واحد.

يتطلب مفتاح واجهة برمجة تطبيقات إدارة بحصة MANAGEMENT_API (أو MANAGEMENT_API_SANDBOX) — راجع نظرة عامة على واجهة برمجة التطبيقات للإدارة — بالإضافة إلى حصة QR_ANALYTICS_OVERVIEW وصلاحية ANALYTICS_CAN_VIEW الخاصتين بالحساب.

string

مجموعة فرعية مفصولة بفواصل من all_time وcurrent_month وlast_months وscan_dates المراد تضمينها. اتركه فارغًا لتضمينها جميعًا.

curl --request GET \
  --url 'https://api.scanova.io/analytics/overview/?type=all_time,current_month,last_months,scan_dates' \
  --header 'Authorization: YOUR_API_KEY'

{
  "all_time": { "total_scans": 18420, "total_qr_codes": 96 },
  "current_month": { "total_scans": 1204, "unique_scans": 980 },
  "last_months": [["2026-06", 3120], ["2026-07", 4410], ["2026-08", 3980]],
  "scan_dates": [["2026-09-01", 42], ["2026-09-02", 51]]
}

هذا هو نفس التجميع الذي تعتمد عليه أداة النظرة العامة في لوحة التحكم — لا يحتوي على نص طلب ولا توجد طريقة لتضييق النطاق إلى رمز QR أو وسم أو مجلد محدد. للحصول على تحليلات مضيَّقة النطاق لمجموعة من رموز QR، استخدم تحليلات QR بدلاً من ذلك.

ذو صلة

تحليلات QR — تحليلات مضيَّقة النطاق لرموز QR أو وسوم أو مجلدات محددة.
سرد تقارير التحليلات — إنشاء تقرير قابل للتنزيل بدلاً من تجميع مباشر.
نظرة عامة على واجهة برمجة التطبيقات للإدارة — مخطط المصادقة وبنية الحصص التي ينتمي إليها هذا الطرف.

التفويضات

Authorization

string

header

مطلوب

Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.

معلمات الاستعلام

type

string

Comma-separated subset of all_time, current_month, last_months, scan_dates.

الاستجابة

200 - application/json

Account-wide analytics overview.

البدء