Statistics

This guide explains how to interact with the Statistics API in the Sumaya369 mobile application. The API provides endpoints for retrieving various statistics including notifications, subscriptions, and general platform metrics.

Notifications Statistics

Retrieve statistics about user notifications, points records, and cart items. This endpoint provides a quick overview of user activity indicators.

Endpoint

• Method: GET
• URL: /v1/mobile/statistics/notifications

Request Headers

Header	Value	Required
Content-Type	application/json	Yes
Accept	application/json	Yes
Authorization	Bearer token	Yes

Success Response

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": {
        "cart_count": 0,
        "notifications_count": 14,
        "points_records_count": 5
    },
    "status_code": 200
}

Subscription Statistics

Retrieve statistics about user's course subscriptions. This endpoint provides the total count of course subscriptions for the authenticated user.

Endpoint

• Method: GET
• URL: /v1/mobile/statistics/subscriptions

Request Headers

Header	Value	Required
Content-Type	application/json	Yes
Accept	application/json	Yes
Authorization	Bearer token	Yes

Success Response

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": {
        "courses_count": 123
    },
    "status_code": 200
}

General Statistics

Retrieve platform-wide statistics including bundle subscriptions, course subscriptions, and visitor analytics for the current year.

Endpoint

• Method: GET
• URL: /v1/mobile/statistics/home

Request Headers

Header	Value	Required
Content-Type	application/json	Yes
Accept	application/json	Yes
Authorization	Bearer token	Yes

Success Response

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": {
        "bundle_subscriptions_count": 259,
        "course_subscriptions_count": 4462,
        "visitors_count": 7298
    },
    "status_code": 200
}

Example Implementation Flow

1. Notifications Statistics

   • Application sends request to /v1/mobile/statistics/notifications
   • Display notification badge with count
   • Show points records count
   • Display cart items count

2. Subscription Statistics

   • Application sends request to /v1/mobile/statistics/subscriptions
   • Display total course subscriptions count

3. General Statistics

   • Application sends request to /v1/mobile/statistics/home
   • Display platform-wide statistics
   • Show year-to-date metrics

Key Considerations

• All counts in notification statistics are capped at 99 for display purposes
• General statistics are calculated for the current year only
• Visitor count is retrieved from Google Analytics
• Bundle subscriptions count only includes completed orders with successful subscription transfers