Hero Sections Endpoint

This guide explains how to interact with the Hero Sections endpoint in the Sumaya369 web application. The endpoint provides data for the hero sections displayed on the home page.

Get Hero Sections Data

Retrieve all active hero sections for the website.

Endpoint

• Method: GET
• URL: /v1/customer/hero-sections

Request Headers

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

Success Response

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": {
        "heroSections": [
            {
                "id": "c917ab50-ef8d-11ef-9fdc-a9b038962d47",
                "title": "عنوان اساسي12",
                "description": "11 لعبة للمال لتبدأ في برنامج استحقاق الثراء لتضاعف متعتك في أثناء سعيك لتحقيق الثراء، وتتعرف على مشاعر وسلوكيات وتطبيقات تدعم تجلي نية الثراء في حياتك.",
                "starts_at": "2025-02-09 10:20:01",
                "ends_at": "2025-04-11 10:20:00",
                "active": true,
                "mobile_image": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/23616/%D8%AA%D8%A7%D8%A8%D9%8A-%D8%AA%D9%85%D8%A7%D8%B1%D8%A7.png",
                "web_image": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/23617/%D8%AA%D8%A7%D8%A8%D9%8A-%D9%88%D8%AA%D9%85%D8%A7%D8%B1%D8%A7-%D8%AC%D9%88%D8%A7%D9%84.png",
                "is_active_section": true,
                "is_active_title": true,
                "is_active_description": true,
                "is_active_banner": true,
                "button_urls": [
                    {
                        "url": "https://testing-storefront.sumaya369.net/",
                        "title": "sdfsdf",
                        "is_active": "true",
                        "is_main_button": "true"
                    }
                ]
            },
            {
                "id": "806d8cf0-ef8d-11ef-b286-f93e93551393",
                "title": "عنوان اساسي11",
                "description": "11 لعبة للمال لتبدأ في برنامج استحقاق الثراء لتضاعف متعتك في أثناء سعيك لتحقيق الثراء، وتتعرف على مشاعر وسلوكيات وتطبيقات تدعم تجلي نية الثراء في حياتك.",
                "starts_at": "2025-02-09 10:20:01",
                "ends_at": "2025-04-11 10:20:00",
                "active": true,
                "mobile_image": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/23614/%D8%AA%D8%A7%D8%A8%D9%8A-%D8%AA%D9%85%D8%A7%D8%B1%D8%A7.png",
                "web_image": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/23615/%D8%AA%D8%A7%D8%A8%D9%8A-%D9%88%D8%AA%D9%85%D8%A7%D8%B1%D8%A7-%D8%AC%D9%88%D8%A7%D9%84.png",
                "is_active_section": true,
                "is_active_title": true,
                "is_active_description": true,
                "is_active_banner": true,
                "button_urls": [
                    {
                        "url": "https://testing-storefront.sumaya369.net/",
                        "title": "sdfsdf",
                        "is_active": "true",
                        "is_main_button": "false"
                    }
                ]
            },
            {
                "id": "5806eca0-ef8d-11ef-a0be-ddd8680d46c3",
                "title": "عنوان اساسي10",
                "description": "11 لعبة للمال لتبدأ في برنامج استحقاق الثراء لتضاعف متعتك في أثناء سعيك لتحقيق الثراء، وتتعرف على مشاعر وسلوكيات وتطبيقات تدعم تجلي نية الثراء في حياتك.",
                "starts_at": "2025-02-09 10:20:01",
                "ends_at": "2025-04-11 10:20:00",
                "active": true,
                "mobile_image": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/23612/%D8%AA%D8%A7%D8%A8%D9%8A-%D8%AA%D9%85%D8%A7%D8%B1%D8%A7.png",
                "web_image": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/23613/%D8%AA%D8%A7%D8%A8%D9%8A-%D9%88%D8%AA%D9%85%D8%A7%D8%B1%D8%A7-%D8%AC%D9%88%D8%A7%D9%84.png",
                "is_active_section": true,
                "is_active_title": true,
                "is_active_description": true,
                "is_active_banner": true,
                "button_urls": [
                    {
                        "url": "https://testing-storefront.sumaya369.net/",
                        "title": "sdfsdf",
                        "is_active": "true",
                        "is_main_button": "true"
                    }
                ]
            },
            {
                "id": "1ae90ed0-ef8d-11ef-895b-c988244d7dff",
                "title": "عنوان اساسي8",
                "description": "11 لعبة للمال لتبدأ في برنامج استحقاق الثراء لتضاعف متعتك في أثناء سعيك لتحقيق الثراء، وتتعرف على مشاعر وسلوكيات وتطبيقات تدعم تجلي نية الثراء في حياتك.",
                "starts_at": "2025-02-09 10:20:01",
                "ends_at": "2025-04-11 10:20:00",
                "active": true,
                "mobile_image": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/23610/%D8%AA%D8%A7%D8%A8%D9%8A-%D8%AA%D9%85%D8%A7%D8%B1%D8%A7.png",
                "web_image": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/23611/%D8%AA%D8%A7%D8%A8%D9%8A-%D9%88%D8%AA%D9%85%D8%A7%D8%B1%D8%A7-%D8%AC%D9%88%D8%A7%D9%84.png",
                "is_active_section": true,
                "is_active_title": true,
                "is_active_description": true,
                "is_active_banner": true,
                "button_urls": [
                    {
                        "url": "https://testing-storefront.sumaya369.net/materials/%D9%85%D8%B5%D8%A7%D8%AF%D8%B1-%D8%A7%D9%84%D8%AB%D8%B1%D8%A7%D8%A1",
                        "title": "اشترك الان",
                        "is_active": "true",
                        "is_main_button": "true"
                    },
                    {
                        "url": "https://testing-storefront.sumaya369.net/materials/%D9%85%D8%B5%D8%A7%D8%AF%D8%B1-%D8%A7%D9%84%D8%AB%D8%B1%D8%A7%D8%A1",
                        "title": "عرض المادة",
                        "is_active": "false",
                        "is_main_button": "false"
                    }
                ]
            },
            {
                "id": "f4b763e0-ef7b-11ef-8946-e75ace843ec1",
                "title": "عنوان اساسي9",
                "description": "الفرعي",
                "starts_at": "2025-02-20 00:01:00",
                "ends_at": "2025-04-11 00:00:00",
                "active": true,
                "mobile_image": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/23608/%D8%AA%D8%A7%D8%A8%D9%8A-%D9%88%D8%AA%D9%85%D8%A7%D8%B1%D8%A7-%D8%AC%D9%88%D8%A7%D9%84.png",
                "web_image": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/23609/%D8%AA%D8%A7%D8%A8%D9%8A-%D8%AA%D9%85%D8%A7%D8%B1%D8%A7.png",
                "is_active_section": true,
                "is_active_title": true,
                "is_active_description": true,
                "is_active_banner": true,
                "button_urls": [
                    {
                        "url": "https://testing-storefront.sumaya369.net/materials",
                        "title": "انقر",
                        "is_active": "true",
                        "is_main_button": "true"
                    },
                    {
                        "url": "https://testing-storefront.sumaya369.net/materials",
                        "title": "تصفح",
                        "is_active": "false",
                        "is_main_button": "false"
                    }
                ]
            },
            {
                "id": "1584c100-ef59-11ef-b1e9-7d8d5d09c190",
                "title": "عنوان اساسي13",
                "description": "11 لعبة للمال لتبدأ في برنامج استحقاق الثراء لتضاعف متعتك في أثناء سعيك لتحقيق الثراء، وتتعرف على مشاعر وسلوكيات وتطبيقات تدعم تجلي نية الثراء في حياتك.11 لعبة للمال لتبدأ في برنامج استحقاق الثراء لتضاعف متعتك في أثناء سعيك لتحقيق الثراء، وتتعرف على مشاعر وسلوكيات وتطبيقات تدعم تجلي نية الثراء في حياتك.",
                "starts_at": "2025-02-20 00:59:01",
                "ends_at": "2025-04-18 00:02:00",
                "active": true,
                "mobile_image": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/23606/%D8%AA%D8%A7%D8%A8%D9%8A-%D9%88%D8%AA%D9%85%D8%A7%D8%B1%D8%A7-%D8%AC%D9%88%D8%A7%D9%84.png",
                "web_image": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/23607/%D8%AA%D8%A7%D8%A8%D9%8A-%D8%AA%D9%85%D8%A7%D8%B1%D8%A7.png",
                "is_active_section": true,
                "is_active_title": true,
                "is_active_description": true,
                "is_active_banner": true,
                "button_urls": [
                    {
                        "url": "https://testing-storefront.sumaya369.net/",
                        "title": "sdfsdf",
                        "is_active": "true",
                        "is_main_button": "true"
                    },
                    {
                        "url": "https://testing-storefront.sumaya369.net/materials",
                        "title": "تصفح المواد",
                        "is_active": "false",
                        "is_main_button": "false"
                    }
                ]
            },
            {
                "id": "d07abce0-ef58-11ef-8a1b-11ab109eced3",
                "title": "عنوان اساسي6",
                "description": "نقدم لك أدوات عملية، دورات تدريبية مميزة، واستشارات موثوقة تساعدك على تجاوز التحديات وتحقيق أهدافك. محتوى مخصص لك ليواكب احتياجاتك ويضعك على الطريق الصحيح نحو النجاح",
                "starts_at": "2025-02-20 00:00:00",
                "ends_at": "2025-03-20 00:00:00",
                "active": true,
                "mobile_image": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/23604/%D8%B3%D9%85%D9%8A%D8%A9-%D8%AC%D9%88%D8%A7%D9%84.jpg",
                "web_image": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/23605/%D8%B3%D9%85%D9%8A%D8%A9-%D8%AC%D9%88%D8%A7%D9%84.jpg",
                "is_active_section": true,
                "is_active_title": true,
                "is_active_description": true,
                "is_active_banner": true,
                "button_urls": [
                    {
                        "url": "https://testing-storefront.sumaya369.net/",
                        "title": "ابدا رحلتك",
                        "is_active": "true",
                        "is_main_button": "true"
                    },
                    {
                        "url": "https://testing-storefront.sumaya369.net/",
                        "title": "انقر",
                        "is_active": "true",
                        "is_main_button": "false"
                    }
                ]
            },
            {
                "id": "46333480-ef54-11ef-8298-3fb84e569e2a",
                "title": "عنوان اساسي5",
                "description": "11 لعبة للمال لتبدأ في برنامج استحقاق الثراء لتضاعف متعتك في أثناء سعيك لتحقيق الثراء، وتتعرف على مشاعر وسلوكيات وتطبيقات تدعم تجلي نية الثراء في حياتك.",
                "starts_at": "2025-02-09 10:20:01",
                "ends_at": "2025-04-11 10:20:00",
                "active": true,
                "mobile_image": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/23602/%D8%AA%D8%A7%D8%A8%D9%8A-%D8%AA%D9%85%D8%A7%D8%B1%D8%A7.png",
                "web_image": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/23603/%D8%AA%D8%A7%D8%A8%D9%8A-%D9%88%D8%AA%D9%85%D8%A7%D8%B1%D8%A7-%D8%AC%D9%88%D8%A7%D9%84.png",
                "is_active_section": true,
                "is_active_title": true,
                "is_active_description": true,
                "is_active_banner": true,
                "button_urls": [
                    {
                        "url": "https://testing-storefront.sumaya369.net/materials/%D9%85%D8%B5%D8%A7%D8%AF%D8%B1-%D8%A7%D9%84%D8%AB%D8%B1%D8%A7%D8%A1",
                        "title": "اشترك الان",
                        "is_active": "true",
                        "is_main_button": "true"
                    },
                    {
                        "url": "https://testing-storefront.sumaya369.net/materials/%D9%85%D8%B5%D8%A7%D8%AF%D8%B1-%D8%A7%D9%84%D8%AB%D8%B1%D8%A7%D8%A1",
                        "title": "عرض المادة",
                        "is_active": "true",
                        "is_main_button": "false"
                    }
                ]
            },
            {
                "id": "1269bb00-ef54-11ef-a0dc-c7de60e72df0",
                "title": "عنوان اساسي4",
                "description": "ستثمر في نفسك اليوم. نوفر لك مواد تعليمية مصممة خصيصًا لأهدافك، مع خيارات دفع مرنة تشمل التقسيط عبر تمارا وتابي",
                "starts_at": "2025-02-09 10:20:01",
                "ends_at": "2025-04-11 10:20:00",
                "active": true,
                "mobile_image": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/23594/%D8%A7%D8%A8%D8%AA%D9%84%D8%B9-%D8%A7%D9%85%D9%88%D8%A7%D9%84%D9%83-%D8%AC%D9%88%D8%A7%D9%84.jpg",
                "web_image": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/23595/%D8%A7%D8%A8%D8%AA%D9%84%D8%B9-%D8%A7%D9%85%D9%88%D8%A7%D9%84%D9%83.jpg",
                "is_active_section": true,
                "is_active_title": true,
                "is_active_description": true,
                "is_active_banner": true,
                "button_urls": [
                    {
                        "url": "https://testing-storefront.sumaya369.net/materials/%D9%85%D8%B5%D8%A7%D8%AF%D8%B1-%D8%A7%D9%84%D8%AB%D8%B1%D8%A7%D8%A1",
                        "title": "اشترك الان",
                        "is_active": "true",
                        "is_main_button": "true"
                    },
                    {
                        "url": "https://testing-storefront.sumaya369.net/materials/%D9%85%D8%B5%D8%A7%D8%AF%D8%B1-%D8%A7%D9%84%D8%AB%D8%B1%D8%A7%D8%A1",
                        "title": "عرض المادة",
                        "is_active": "true",
                        "is_main_button": "false"
                    }
                ]
            },
            {
                "id": "ef6b8f50-ef4c-11ef-91d1-89c945e52363",
                "title": "عنوان اساسي 7",
                "description": "فرعي",
                "starts_at": "2025-02-20 00:00:00",
                "ends_at": "2025-04-10 00:01:01",
                "active": true,
                "mobile_image": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/23590/%D8%AA%D8%A7%D8%A8%D9%8A-%D8%AA%D9%85%D8%A7%D8%B1%D8%A7.png",
                "web_image": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/23591/%D8%AA%D8%A7%D8%A8%D9%8A-%D8%AA%D9%85%D8%A7%D8%B1%D8%A7.png",
                "is_active_section": true,
                "is_active_title": true,
                "is_active_description": true,
                "is_active_banner": true,
                "button_urls": [
                    {
                        "url": "https://testing-storefront.sumaya369.net/",
                        "title": "sdfsdf",
                        "is_active": "true",
                        "is_main_button": "true"
                    }
                ]
            },
            {
                "id": "bfe41770-ef4b-11ef-a347-0f0b9345c43c",
                "title": "عنوان اساسي3",
                "description": "نقدم لك أدوات عملية، دورات تدريبية مميزة، واستشارات موثوقة تساعدك على تجاوز التحديات وتحقيق أهدافك. محتوى مخصص لك ليواكب احتياجاتك ويضعك على الطريق الصحيح نحو النجاح",
                "starts_at": "2025-02-09 10:20:01",
                "ends_at": "2025-04-11 10:20:00",
                "active": true,
                "mobile_image": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/23592/%D8%B3%D9%85%D9%8A%D8%A9-%D8%AC%D9%88%D8%A7%D9%84.jpg",
                "web_image": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/23593/%D8%B3%D9%85%D9%8A%D8%A9-%D8%AC%D9%88%D8%A7%D9%84.jpg",
                "is_active_section": true,
                "is_active_title": true,
                "is_active_description": true,
                "is_active_banner": true,
                "button_urls": [
                    {
                        "url": "https://testing-storefront.sumaya369.net/materials/%D9%85%D8%B5%D8%A7%D8%AF%D8%B1-%D8%A7%D9%84%D8%AB%D8%B1%D8%A7%D8%A1",
                        "title": "اشترك الان",
                        "is_active": "true",
                        "is_main_button": "true"
                    },
                    {
                        "url": "https://testing-storefront.sumaya369.net/materials/%D9%85%D8%B5%D8%A7%D8%AF%D8%B1-%D8%A7%D9%84%D8%AB%D8%B1%D8%A7%D8%A1",
                        "title": "عرض المادة",
                        "is_active": "true",
                        "is_main_button": "false"
                    }
                ]
            },
            {
                "id": "8678b920-ef39-11ef-a92b-e7d9b3aeb162",
                "title": "عنوان اساسي2",
                "description": "عنوان فرعي",
                "starts_at": "2025-02-09 10:20:01",
                "ends_at": "2025-04-11 10:20:00",
                "active": true,
                "mobile_image": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/23580/%D8%B3%D9%85%D9%8A%D8%A9-%D8%AC%D9%88%D8%A7%D9%84.jpeg",
                "web_image": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/23581/%D8%B3%D9%85%D9%8A%D8%A9-%D8%AC%D9%88%D8%A7%D9%84.jpeg",
                "is_active_section": true,
                "is_active_title": true,
                "is_active_description": true,
                "is_active_banner": true,
                "button_urls": [
                    {
                        "url": "https://testing-storefront.sumaya369.net/",
                        "title": "تصفح",
                        "is_main_button": "true",
                        "is_active": "true"
                    },
                    {
                        "title": "تعلم",
                        "url": "https://testing-storefront.sumaya369.net/materials",
                        "is_main_button": "false",
                        "is_active": "true"
                    }
                ]
            },
            {
                "id": "086ad180-ef37-11ef-964e-0f55cc817bc5",
                "title": "عنوان اساسي1",
                "description": "عنوان فرعي",
                "starts_at": "2025-02-09 10:20:01",
                "ends_at": "2025-04-11 10:20:00",
                "active": true,
                "mobile_image": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/23576/%D8%B3%D9%85%D9%8A%D8%A9-%D8%AC%D9%88%D8%A7%D9%84.jpeg",
                "web_image": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/23577/%D8%B3%D9%85%D9%8A%D8%A9-%D8%AC%D9%88%D8%A7%D9%84.jpeg",
                "is_active_section": false,
                "is_active_title": false,
                "is_active_description": false,
                "is_active_banner": true,
                "button_urls": [
                    {
                        "url": "https://testing-storefront.sumaya369.net/",
                        "title": "تصفح",
                        "is_main_button": "true",
                        "is_active": "false"
                    },
                    {
                        "title": "تعلم",
                        "url": "https://testing-storefront.sumaya369.net/materials",
                        "is_main_button": "false",
                        "is_active": "false"
                    }
                ]
            }
        ]
    },
    "status_code": 200
}

Implementation Notes

• Returns only active and unexpired hero sections
• Includes associated media files for each hero section
• Sections are sorted by creation date in descending order
• No caching is implemented for this endpoint
• Media information includes file details and storage location