Bundles Endpoint

This guide explains how to interact with the Bundles endpoint in the Sumaya369 web application. The endpoint provides data for bundles displayed on the home page.

Get Bundles Data

Retrieve all bundles data for the home page.

Endpoint

• Method: GET
• URL: /v1/customer/home-bundles

Request Headers

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

Success Response

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": {
        "current_page": 1,
        "first_page_url": "http://testing-api.sumaya369.net/v1/customer/home-bundles?page=1",
        "from": 1,
        "last_page": 7,
        "last_page_url": "http://testing-api.sumaya369.net/v1/customer/home-bundles?page=7",
        "links": [
            {
                "url": null,
                "label": "« السابق",
                "active": false
            },
            {
                "url": "http://testing-api.sumaya369.net/v1/customer/home-bundles?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": "http://testing-api.sumaya369.net/v1/customer/home-bundles?page=2",
                "label": "2",
                "active": false
            },
            {
                "url": "http://testing-api.sumaya369.net/v1/customer/home-bundles?page=3",
                "label": "3",
                "active": false
            },
            {
                "url": "http://testing-api.sumaya369.net/v1/customer/home-bundles?page=4",
                "label": "4",
                "active": false
            },
            {
                "url": "http://testing-api.sumaya369.net/v1/customer/home-bundles?page=5",
                "label": "5",
                "active": false
            },
            {
                "url": "http://testing-api.sumaya369.net/v1/customer/home-bundles?page=6",
                "label": "6",
                "active": false
            },
            {
                "url": "http://testing-api.sumaya369.net/v1/customer/home-bundles?page=7",
                "label": "7",
                "active": false
            },
            {
                "url": "http://testing-api.sumaya369.net/v1/customer/home-bundles?page=2",
                "label": "التالي »",
                "active": false
            }
        ],
        "next_page_url": "http://testing-api.sumaya369.net/v1/customer/home-bundles?page=2",
        "path": "http://testing-api.sumaya369.net/v1/customer/home-bundles",
        "per_page": 2,
        "prev_page_url": null,
        "to": 2,
        "total": 13,
        "bundles": [
            {
                "id": "cf145b70-c795-11ef-b586-eb5871aabd0d",
                "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/23451/preview_10330455_718163334873481_6240767596807275245_n.jpg",
                "name": "باقة النجاح",
                "slug": "باقة-النجاح-1",
                "description": "jijiojj...",
                "old_price": 528.7,
                "is_purchasable": true,
                "can_purchase": true,
                "hide_price": false,
                "can_comment": true,
                "has_active_subscribed": false,
                "price": "80.00",
                "price_difference": 448.7,
                "does_has_vat": true,
                "price_with_vat_show": 92,
                "products_count": 3,
                "model_type": "bundles",
                "has_newly_added": false,
                "pay_button_title": "أضف للسلة",
                "pay_button_status": true,
                "has_available_special_link": false,
                "favorite": null
            },
            {
                "id": "09d53ec0-b305-11ef-98a6-735d2de688a2",
                "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/23410/%D8%A7%D9%84%D8%B3%D9%84%D8%A9.png",
                "name": "الباقه الباقه",
                "slug": "الباقه-الباقه",
                "description": "الباقه...",
                "old_price": 280.88,
                "is_purchasable": true,
                "can_purchase": true,
                "hide_price": false,
                "can_comment": false,
                "has_active_subscribed": false,
                "price": "250.00",
                "price_difference": 30.88,
                "does_has_vat": true,
                "price_with_vat_show": 287.5,
                "products_count": 3,
                "model_type": "bundles",
                "has_newly_added": false,
                "pay_button_title": "أضف للسلة",
                "pay_button_status": true,
                "has_available_special_link": false,
                "favorite": null
            }
        ]
    },
    "status_code": 200
}

Implementation Notes

• The endpoint uses response caching for unauthorized users to improve performance
• Cache duration is set to 60 minutes for unauthorized users
• Authenticated users always receive fresh data
• Returns a collection of bundle data formatted for the home page display