Skip to main content

Month Wallpapers

The Month Wallpapers API provides access to download the first active wallpaper.

Get First Active Wallpaper​

Retrieve the currently selected (active) month wallpaper.

Endpoint​

  • Method: GET
  • URL: /v1/mobile/month-wallpapers/wallpaper

Request Headers​

HeaderValueRequired
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/month-wallpapers/first-active
  • Returns the currently selected wallpaper
  • Returns null if no wallpaper is selected (mobile platform)

Key Considerations​

  • Only one wallpaper can be marked as selected at a time
  • Platform-specific behavior for missing active wallpapers
  • Media files are stored using the media library system
  • Response includes media information for proper file handling