Skip to main content

Monthly Events

The Monthly Events API provides access to monthly event pages within the Sumaya369 platform. This API enables users to view monthly event content.

List Monthly Events​

Retrieve the monthly events page content. This endpoint returns the current monthly event information along with any associated media and content.

Endpoint​

  • Method: GET
  • URL: /v1/mobile/monthly-events

Request Headers​

HeaderValueRequired
Content-Typeapplication/jsonYes
Acceptapplication/jsonYes

Success Response​

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": {
        "id": "29686010-c814-11ef-a3ca-6d6121278541",
        "name": "الثراء",
        "date": "2025-01-01",
        "custom_date": "2025 Jan",
        "poster": "http://127.0.0.1:8000/storage/28581/خلفية-شهر-جانوري-2025_مقاس-موقع.png",
        "displayed": true,
        "selected": true,
        "created_at": "2025-01-01 10:43:59"
    },
    "status_code": 200
}

Implementation Flow​

  • Application sends request to /v1/mobile/monthly-events
  • Display monthly event content and media

Key Considerations​

  • Server-side caching is implemented for unauthorized users
  • Views are tracked using the CustomVisitor implementation
  • Action views are recorded for analytics purposes