Skip to main content

Courses

This guide explains how to interact with the Courses API in Sumaya369 web application.

List Courses​

Endpoint​

  • Method: GET
  • URL: /v1/customer/courses

Request Headers​

HeaderValueRequired
Content-Typeapplication/jsonYes
Acceptapplication/jsonYes

Query Parameters​

ParameterTypeDescriptionRequired
per_pageintegerNumber of courses per page (default: 10)No
categorystringFilter courses by category nameNo
search_textstringSearch in course name and descriptionNo
material_typesarrayFilter by material typesNo
body_typesarrayFilter by body typesNo
awareness_levelsarrayFilter by awareness levelsNo
has_reduced_pricebooleanFilter courses with reduced priceNo
is_purchasablebooleanFilter purchasable coursesNo
sortstringSort field (e.g., total_price)No

Success Response​

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": {
        "current_page": 1,
        "first_page_url": "http://testing-api.sumaya369.net/v1/customer/courses?per_page=100&page=1",
        "from": 1,
        "last_page": 1,
        "last_page_url": "http://testing-api.sumaya369.net/v1/customer/courses?per_page=100&page=1",
        "links": [
            {
                "url": null,
                "label": "« السابق",
                "active": false
            },
            {
                "url": "http://testing-api.sumaya369.net/v1/customer/courses?per_page=100&page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "التالي »",
                "active": false
            }
        ],
        "next_page_url": null,
        "path": "http://testing-api.sumaya369.net/v1/customer/courses",
        "per_page": 100,
        "prev_page_url": null,
        "to": 12,
        "total": 12,
        "seo": {
            "keywords": "الدكتورة سمية الناصر,موقع الدكتورة سمية الناصر,دورات سمية الناصر,مقالات سمية الناصر,سمية الناصر الموقع الرسمي,كتب تتحدث عن الجسد المشاعري,sumaya369,الجسد المشاعري,خريطة المشاعر",
            "author": "الدكتورة سمية الناصر",
            "description": "الموقع الرسمي لدكتورة سمية الناصر| مواد - مقالات - كتب - اصدارات.",
            "title": "الرئيسية"
        },
        "courses": [
            {
                "id": "c0334a00-f610-11ec-9468-edc40d386ec9",
                "slug": "قانون-التجرد",
                "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/22674/1--%D9%82%D8%A7%D9%86%D9%88%D9%86-%D8%A7%D9%84%D8%AA%D8%AC%D8%B1%D8%AF.png",
                "name": "قانون التجرد",
                "old_price": 480,
                "is_purchasable": true,
                "has_active_subscribed": false,
                "hide_price": false,
                "videos_count": 18,
                "price": 480,
                "does_has_vat": true,
                "has_available_special_link": true,
                "price_with_vat_show": 552,
                "model_type": "courses",
                "pay_button_title": "أضف للسلة",
                "pay_button_status": true,
                "has_reduced_price": false,
                "favorite": null,
                "tags": [
                    {
                        "id": "f143c2d0-fb24-11ee-a115-5717ccd382dd",
                        "name": "مفاهيم بسيطة",
                        "color": null
                    },
                    {
                        "id": "c60fa260-fb24-11ee-af71-350be8551fdb",
                        "name": "تطبيقات بسيطة",
                        "color": null
                    },
                    {
                        "id": "965e3cc0-fb24-11ee-9658-b558db5ba9ce",
                        "name": "للجسد المشاعري",
                        "color": null
                    },
                    {
                        "id": "e1c29880-fb45-11ee-bc1f-411ddde840e6",
                        "name": "مادة للتطوير",
                        "color": null
                    }
                ],
                "rating": 4.9,
                "ratings_count": "30"
            },
            {
                "id": "36859da0-d6d7-11ee-951d-a54807335841",
                "slug": "كيف-ضاعت-قداستك",
                "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/21599/7--%D9%83%D9%8A%D9%81-%D8%B6%D8%A7%D8%B9%D8%AA-%D9%82%D8%AF%D8%B3%D9%8A%D8%AA%D9%83_%D9%85%D9%82%D8%A7%D8%B3-%D8%A7%D9%84%D9%85%D9%88%D9%82%D8%B9-min.png",
                "name": "كيف ضاعت قداستك؟",
                "old_price": 120,
                "is_purchasable": true,
                "has_active_subscribed": false,
                "hide_price": false,
                "videos_count": 6,
                "price": 120,
                "does_has_vat": true,
                "has_available_special_link": true,
                "price_with_vat_show": 138,
                "model_type": "courses",
                "pay_button_title": "طلب المادة",
                "pay_button_status": true,
                "has_reduced_price": false,
                "favorite": null,
                "tags": [
                    {
                        "id": "f143c2d0-fb24-11ee-a115-5717ccd382dd",
                        "name": "مفاهيم بسيطة",
                        "color": null
                    },
                    {
                        "id": "c60fa260-fb24-11ee-af71-350be8551fdb",
                        "name": "تطبيقات بسيطة",
                        "color": null
                    },
                    {
                        "id": "8ac69550-fb24-11ee-9b42-a9ba0b522f2c",
                        "name": "للجسد الروحي",
                        "color": null
                    },
                    {
                        "id": "cb141570-fb23-11ee-b87e-c52f28f5e2a5",
                        "name": "للجسد الفكري",
                        "color": null
                    },
                    {
                        "id": "e1c29880-fb45-11ee-bc1f-411ddde840e6",
                        "name": "مادة للتطوير",
                        "color": null
                    }
                ],
                "rating": 4.9,
                "ratings_count": "93"
            },
            {
                "id": "681cb9b0-fe09-11ed-a3a3-c53074eee558",
                "slug": "قصة-الشعور",
                "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/22671/2--%D9%82%D8%B5%D8%A9-%D8%A7%D9%84%D8%B4%D8%B9%D9%88%D8%B1.png",
                "name": "قصة الشعور",
                "old_price": 690.44,
                "is_purchasable": true,
                "has_active_subscribed": false,
                "hide_price": false,
                "videos_count": 12,
                "price": 690.44,
                "does_has_vat": true,
                "has_available_special_link": true,
                "price_with_vat_show": 794.01,
                "model_type": "courses",
                "pay_button_title": "طلب المادة",
                "pay_button_status": true,
                "has_reduced_price": false,
                "favorite": null,
                "tags": [
                    {
                        "id": "6d356c70-fb23-11ee-8b8e-f56be7e8889f",
                        "name": "مفاهيم عميقة",
                        "color": null
                    },
                    {
                        "id": "95318a30-fb23-11ee-86d1-a5ccc3e103dd",
                        "name": "تطبيقات عميقة",
                        "color": null
                    },
                    {
                        "id": "965e3cc0-fb24-11ee-9658-b558db5ba9ce",
                        "name": "للجسد المشاعري",
                        "color": null
                    },
                    {
                        "id": "e1c29880-fb45-11ee-bc1f-411ddde840e6",
                        "name": "مادة للتطوير",
                        "color": null
                    }
                ],
                "rating": 4.9,
                "ratings_count": "118"
            },
            {
                "id": "ce31e4d0-fe0b-11ed-8966-83608074a91f",
                "slug": "اسئلة-الجسد-المشاعري",
                "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/22667/6--%D8%A7%D8%B3%D8%A6%D9%84%D8%A9-%D8%A7%D9%84%D8%AC%D8%B3%D8%AF-%D8%A7%D9%84%D9%85%D8%B4%D8%A7%D8%B9%D8%B1%D9%8A.png",
                "name": "اسئلة الجسد المشاعري",
                "old_price": 190.44,
                "is_purchasable": true,
                "has_active_subscribed": false,
                "hide_price": false,
                "videos_count": 0,
                "price": 190.44,
                "does_has_vat": true,
                "has_available_special_link": true,
                "price_with_vat_show": 219.01,
                "model_type": "courses",
                "pay_button_title": "طلب المادة",
                "pay_button_status": true,
                "has_reduced_price": false,
                "favorite": null,
                "tags": [
                    {
                        "id": "f143c2d0-fb24-11ee-a115-5717ccd382dd",
                        "name": "مفاهيم بسيطة",
                        "color": null
                    },
                    {
                        "id": "c60fa260-fb24-11ee-af71-350be8551fdb",
                        "name": "تطبيقات بسيطة",
                        "color": null
                    },
                    {
                        "id": "965e3cc0-fb24-11ee-9658-b558db5ba9ce",
                        "name": "للجسد المشاعري",
                        "color": null
                    },
                    {
                        "id": "e1c29880-fb45-11ee-bc1f-411ddde840e6",
                        "name": "مادة للتطوير",
                        "color": null
                    }
                ],
                "rating": 5,
                "ratings_count": "11"
            },
            {
                "id": "c8cdb4a0-44c3-11ee-bbf4-37836d47a796",
                "slug": "التأمل-107",
                "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/16602/%D8%B5%D9%88%D8%B1%D8%A92.png",
                "name": "التأمل (107)",
                "old_price": 35.65,
                "is_purchasable": true,
                "has_active_subscribed": false,
                "hide_price": false,
                "videos_count": 1,
                "price": 35.65,
                "does_has_vat": true,
                "has_available_special_link": true,
                "price_with_vat_show": 41,
                "model_type": "courses",
                "pay_button_title": "الطلب قيد المراجعة",
                "pay_button_status": false,
                "has_reduced_price": false,
                "favorite": null,
                "tags": [
                    {
                        "id": "f143c2d0-fb24-11ee-a115-5717ccd382dd",
                        "name": "مفاهيم بسيطة",
                        "color": null
                    },
                    {
                        "id": "c60fa260-fb24-11ee-af71-350be8551fdb",
                        "name": "تطبيقات بسيطة",
                        "color": null
                    },
                    {
                        "id": "b0a914a0-fb24-11ee-a5d1-635be7334767",
                        "name": "للجسد الطاقي",
                        "color": null
                    },
                    {
                        "id": "e1c29880-fb45-11ee-bc1f-411ddde840e6",
                        "name": "مادة للتطوير",
                        "color": null
                    }
                ],
                "rating": 0,
                "ratings_count": "0"
            },
            {
                "id": "644c9940-d6d5-11ee-9bcd-37caa6e58047",
                "slug": "أسرار-روحية",
                "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/21600/3--%D8%A7%D8%B3%D8%B1%D8%A7%D8%B1-%D8%B1%D9%88%D8%AD%D9%8A%D8%A9_%D9%85%D9%82%D8%A7%D8%B3-%D8%A7%D9%84%D9%85%D9%88%D9%82%D8%B9-min.png",
                "name": "أسرار روحية",
                "old_price": 978.33,
                "is_purchasable": true,
                "has_active_subscribed": false,
                "hide_price": false,
                "videos_count": 10,
                "price": 978.33,
                "does_has_vat": true,
                "has_available_special_link": false,
                "price_with_vat_show": 1125.08,
                "model_type": "courses",
                "pay_button_title": "أخبرني عند التوفر",
                "pay_button_status": true,
                "has_reduced_price": false,
                "favorite": null,
                "tags": [
                    {
                        "id": "e4b89f90-fb24-11ee-b8da-85ef5b834ca6",
                        "name": "مفاهيم متوسطة",
                        "color": null
                    },
                    {
                        "id": "d41a8580-fb24-11ee-9672-ad75a3f41a4a",
                        "name": "تطبيقات متوسطة",
                        "color": null
                    },
                    {
                        "id": "8ac69550-fb24-11ee-9b42-a9ba0b522f2c",
                        "name": "للجسد الروحي",
                        "color": null
                    },
                    {
                        "id": "cb141570-fb23-11ee-b87e-c52f28f5e2a5",
                        "name": "للجسد الفكري",
                        "color": null
                    },
                    {
                        "id": "e1c29880-fb45-11ee-bc1f-411ddde840e6",
                        "name": "مادة للتطوير",
                        "color": null
                    }
                ],
                "rating": 4.9,
                "ratings_count": "22"
            },
        ]
    },
    "status_code": 200
}

Get Single Course​

Endpoint​

  • Method: GET
  • URL: /v1/customer/courses/{id_or_slug}

The endpoint accepts either a course ID or a special slug identifier.

Request Headers​

HeaderValueRequired
Content-Typeapplication/jsonYes
Acceptapplication/jsonYes
AuthorizationBearer tokenRequired for non-open-source courses and special id links

Path Parameters​

ParameterTypeDescriptionRequired
id_or_slugstringCourse ID or special slug identifierYes

Success Response (Not Authenticated \ No Active Subscription)​

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": {
        "id": "644c9940-d6d5-11ee-9bcd-37caa6e58047",
        "slug": "أسرار-روحية",
        "special_id": "644c9940-d6d5-11ee-9bcd-37caa6e58047",
        "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/21600/3--%D8%A7%D8%B3%D8%B1%D8%A7%D8%B1-%D8%B1%D9%88%D8%AD%D9%8A%D8%A9_%D9%85%D9%82%D8%A7%D8%B3-%D8%A7%D9%84%D9%85%D9%88%D9%82%D8%B9-min.png",
        "name": "أسرار روحية",
        "old_price": 978.33,
        "course_description": "",
        "subscription_status_date": "غير مشترك",
        "videos_count": 10,
        "price": 978.33,
        "does_has_vat": true,
        "price_with_vat_show": 1125.08,
        "tags": [
            {
                "id": "e4b89f90-fb24-11ee-b8da-85ef5b834ca6",
                "name": "مفاهيم متوسطة",
                "color": "#A99CE0FF"
            },
            {
                "id": "d41a8580-fb24-11ee-9672-ad75a3f41a4a",
                "name": "تطبيقات متوسطة",
                "color": "#E296E2FF"
            },
            {
                "id": "8ac69550-fb24-11ee-9b42-a9ba0b522f2c",
                "name": "للجسد الروحي",
                "color": "#92CECEFF"
            },
            {
                "id": "cb141570-fb23-11ee-b87e-c52f28f5e2a5",
                "name": "للجسد الفكري",
                "color": "#98DEDEFF"
            },
            {
                "id": "e1c29880-fb45-11ee-bc1f-411ddde840e6",
                "name": "مادة للتطوير",
                "color": "#F7F7F7FF"
            }
        ],
        "can_rate": false,
        "can_write_rate_comment": false,
        "comments_count": 4,
        "can_be_bought": null,
        "rates_count": "22",
        "can_comment": true,
        "is_purchasable": true,
        "can_purchase": true,
        "hide_price": false,
        "is_open_source": false,
        "product_availability_expired_timer": null,
        "has_active_subscribed": false,
        "can_download_summary": false,
        "can_download_certificate": false,
        "summary": "",
        "length": "04:14:00",
        "duration": "730 يوم",
        "is_instant_subscription": null,
        "summary_name": "",
        "certificate": "",
        "certificate_price": 0,
        "summary_price": 0,
        "has_certificate": false,
        "has_promotional": false,
        "has_summary": false,
        "rating_avg": 4.9,
        "is_special_id": false,
        "has_special_id": false,
        "watched_videos_count": 0,
        "model_type": "courses",
        "product_description": "<h3>اسرار روحية</h3><p><strong>ستعرف مع هذه المادة : </strong></p><p><br></p><ul><li>لماذا هناك أسرار عن الروح؟</li><li>الاستنارة</li><li>الرحلات الروحية</li><li>الطقوس الروحية</li><li>العقد الصوتي</li><li>عالم الشر</li><li>الكونداليني</li></ul><p><br></p><p><br></p><p>*هذه المادة مناسبة للحامل</p><p>*هذه المادة مناسبة للمرضع</p><p><br></p><hr><p><br></p><p><br></p><p class=\"ql-align-right\"><strong style=\"color: black;\">بشراءك أي منتج تفيد أنك قد قرأت ووافقت على </strong><a href=\"https://sumaya369.net/privacy-policy\" rel=\"noopener noreferrer\" target=\"_blank\"><strong>الشروط والأحكام</strong></a></p><p class=\"ql-align-right\"><strong>للمساعدة : </strong><a href=\"https://sumaya369.net/FAQ\" rel=\"noopener noreferrer\" target=\"_blank\"><strong>تواصل معنا</strong></a></p><p class=\"ql-align-right\"><br></p><p class=\"ql-align-right\"><br></p><p class=\"ql-align-right\"><br></p><p class=\"ql-align-right\"><br></p><p class=\"ql-align-right\"><br></p><p class=\"ql-align-right\"><br></p>",
        "pay_button_title": "أخبرني عند التوفر",
        "pay_button_status": true,
        "to_be_learn": null,
        "subscriptions_count": "295",
        "awareness_levels": [],
        "material_types": [],
        "has_available_special_link": false,
        "url": "https://testing-storefront.sumaya369.net/courses/644c9940-d6d5-11ee-9bcd-37caa6e58047",
        "favorite": null,
        "courses_that_may_interest_you": [],
        "notes": [],
        "videos": [
            {
                "id": "64522560-d6d5-11ee-8e0b-55501d70a9dc",
                "number": 1,
                "title": "مقدمـة",
                "length": "00:00:00",
                "is_promotional": false,
                "description": null
            },
            {
                "id": "6455d750-d6d5-11ee-b803-17e13d95dda6",
                "number": 2,
                "title": "شق الصدر",
                "length": "00:00:00",
                "is_promotional": false,
                "description": null
            },
            {
                "id": "6458c7a0-d6d5-11ee-a709-3b1ca25a572a",
                "number": 3,
                "title": "الشهقة",
                "length": "00:00:00",
                "is_promotional": false,
                "description": null
            },
            {
                "id": "645b7f00-d6d5-11ee-9a6a-afd614ca1418",
                "number": 4,
                "title": "الاستنارة",
                "length": "00:00:00",
                "is_promotional": false,
                "description": null
            },
            {
                "id": "645e6050-d6d5-11ee-8541-5546f6c6e811",
                "number": 5,
                "title": "الرحلات الروحية",
                "length": "00:00:00",
                "is_promotional": false,
                "description": null
            },
            {
                "id": "64610890-d6d5-11ee-9073-05d9a8e133df",
                "number": 6,
                "title": "الطقوس الروحية",
                "length": "00:00:00",
                "is_promotional": false,
                "description": null
            },
            {
                "id": "6463e7b0-d6d5-11ee-bc8f-75ad08019270",
                "number": 7,
                "title": "العقد الصوتي",
                "length": "00:00:00",
                "is_promotional": false,
                "description": null
            },
            {
                "id": "64668e60-d6d5-11ee-b8e2-69ee96d6ee37",
                "number": 8,
                "title": "طبقات الروح",
                "length": "00:00:00",
                "is_promotional": false,
                "description": null
            },
            {
                "id": "64694160-d6d5-11ee-8c36-c1a953b92b06",
                "number": 9,
                "title": "عالم الشر",
                "length": "00:00:00",
                "is_promotional": false,
                "description": null
            },
            {
                "id": "646c5720-d6d5-11ee-996d-4570f2e7b928",
                "number": 10,
                "title": "الكونداليني",
                "length": "00:00:00",
                "is_promotional": false,
                "description": null
            }
        ],
        "unowned_videos": null,
        "video_button_text": "إكمال الدفع",
        "video_button_status": true,
        "attachments": [],
        "attachments_count": 0,
        "seo": {
            "title": "مادة أسرار روحية",
            "description": "...",
            "image": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/21600/3--%D8%A7%D8%B3%D8%B1%D8%A7%D8%B1-%D8%B1%D9%88%D8%AD%D9%8A%D8%A9_%D9%85%D9%82%D8%A7%D8%B3-%D8%A7%D9%84%D9%85%D9%88%D9%82%D8%B9-min.png",
            "type": "courses",
            "locale": "ar_SA",
            "site_name": "Sumaya369",
            "keywords": "الدكتورة سمية الناصر,موقع الدكتورة سمية الناصر,دورات سمية الناصر,مقالات سمية الناصر,سمية الناصر الموقع الرسمي,كتب تتحدث عن الجسد المشاعري,sumaya369,الجسد المشاعري,خريطة المشاعر",
            "author": "الدكتورة سمية الناصر",
            "published_time": "2024-02-29T10:37:29+03:00",
            "modified_time": "2025-02-19T17:14:39+03:00",
            "article_tags": "مفاهيم متوسطة,تطبيقات متوسطة,للجسد الروحي,للجسد الفكري,مادة للتطوير",
            "article_section": "مادة"
        },
        "is_rating_skipped": false,
        "target_audience_description": "<p class=\"ql-align-right\"><br></p>",
        "is_target_audience_active": false,
        "display_before_products": false,
        "display_after_products": false
    },
    "status_code": 200
}

Success Response (Authenticated And Active Subscription)​

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": {
        "id": "644c9940-d6d5-11ee-9bcd-37caa6e58047",
        "slug": "أسرار-روحية",
        "special_id": "644c9940-d6d5-11ee-9bcd-37caa6e58047",
        "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/21600/3--%D8%A7%D8%B3%D8%B1%D8%A7%D8%B1-%D8%B1%D9%88%D8%AD%D9%8A%D8%A9_%D9%85%D9%82%D8%A7%D8%B3-%D8%A7%D9%84%D9%85%D9%88%D9%82%D8%B9-min.png",
        "name": "أسرار روحية",
        "old_price": 978.33,
        "course_description": "<p class=\"ql-align-right\"><br></p>",
        "subscription_status_date": "سينتهي اشتراكك بعد 612 يوم",
        "videos_count": 10,
        "price": 978.33,
        "does_has_vat": true,
        "price_with_vat_show": 1125.08,
        "tags": [
            {
                "id": "e4b89f90-fb24-11ee-b8da-85ef5b834ca6",
                "name": "مفاهيم متوسطة",
                "color": "#A99CE0FF"
            },
            {
                "id": "d41a8580-fb24-11ee-9672-ad75a3f41a4a",
                "name": "تطبيقات متوسطة",
                "color": "#E296E2FF"
            },
            {
                "id": "8ac69550-fb24-11ee-9b42-a9ba0b522f2c",
                "name": "للجسد الروحي",
                "color": "#92CECEFF"
            },
            {
                "id": "cb141570-fb23-11ee-b87e-c52f28f5e2a5",
                "name": "للجسد الفكري",
                "color": "#98DEDEFF"
            },
            {
                "id": "e1c29880-fb45-11ee-bc1f-411ddde840e6",
                "name": "مادة للتطوير",
                "color": "#F7F7F7FF"
            }
        ],
        "can_rate": true,
        "can_write_rate_comment": true,
        "comments_count": 4,
        "can_be_bought": null,
        "rates_count": "22",
        "can_comment": true,
        "is_purchasable": true,
        "can_purchase": true,
        "hide_price": false,
        "is_open_source": false,
        "product_availability_expired_timer": null,
        "has_active_subscribed": true,
        "can_download_summary": false,
        "can_download_certificate": false,
        "summary": "",
        "length": "04:14:00",
        "duration": "متبقي 612 يوم للاشتراك",
        "is_instant_subscription": null,
        "summary_name": "",
        "certificate": "",
        "certificate_price": 0,
        "summary_price": 0,
        "has_certificate": false,
        "has_promotional": false,
        "has_summary": false,
        "rating_avg": 4.9,
        "is_special_id": false,
        "has_special_id": false,
        "watched_videos_count": 2,
        "model_type": "courses",
        "product_description": "<h3>اسرار روحية</h3><p><strong>ستعرف مع هذه المادة : </strong></p><p><br></p><ul><li>لماذا هناك أسرار عن الروح؟</li><li>الاستنارة</li><li>الرحلات الروحية</li><li>الطقوس الروحية</li><li>العقد الصوتي</li><li>عالم الشر</li><li>الكونداليني</li></ul><p><br></p><p><br></p><p>*هذه المادة مناسبة للحامل</p><p>*هذه المادة مناسبة للمرضع</p><p><br></p><hr><p><br></p><p><br></p><p class=\"ql-align-right\"><strong style=\"color: black;\">بشراءك أي منتج تفيد أنك قد قرأت ووافقت على </strong><a href=\"https://sumaya369.net/privacy-policy\" rel=\"noopener noreferrer\" target=\"_blank\"><strong>الشروط والأحكام</strong></a></p><p class=\"ql-align-right\"><strong>للمساعدة : </strong><a href=\"https://sumaya369.net/FAQ\" rel=\"noopener noreferrer\" target=\"_blank\"><strong>تواصل معنا</strong></a></p><p class=\"ql-align-right\"><br></p><p class=\"ql-align-right\"><br></p><p class=\"ql-align-right\"><br></p><p class=\"ql-align-right\"><br></p><p class=\"ql-align-right\"><br></p><p class=\"ql-align-right\"><br></p>",
        "pay_button_title": "مشترك",
        "pay_button_status": true,
        "to_be_learn": null,
        "subscriptions_count": "295",
        "awareness_levels": [],
        "material_types": [],
        "has_available_special_link": false,
        "url": "https://testing-storefront.sumaya369.net/courses/644c9940-d6d5-11ee-9bcd-37caa6e58047",
        "favorite": null,
        "courses_that_may_interest_you": [],
        "notes": [],
        "videos": [
            {
                "id": "64522560-d6d5-11ee-8e0b-55501d70a9dc",
                "number": 1,
                "title": "مقدمـة",
                "description": null,
                "video_id": 916801182,
                "length": "00:00:00",
                "user_notes_count": 0,
                "is_watched": false,
                "watched_id": null,
                "stopped_in": null,
                "is_promotional": false
            },
            {
                "id": "6455d750-d6d5-11ee-b803-17e13d95dda6",
                "number": 2,
                "title": "شق الصدر",
                "description": null,
                "video_id": 916803344,
                "length": "00:00:00",
                "user_notes_count": 0,
                "is_watched": false,
                "watched_id": null,
                "stopped_in": null,
                "is_promotional": false
            },
            {
                "id": "6458c7a0-d6d5-11ee-a709-3b1ca25a572a",
                "number": 3,
                "title": "الشهقة",
                "description": null,
                "video_id": 916806361,
                "length": "00:00:00",
                "user_notes_count": 0,
                "is_watched": false,
                "watched_id": null,
                "stopped_in": null,
                "is_promotional": false
            },
            {
                "id": "645b7f00-d6d5-11ee-9a6a-afd614ca1418",
                "number": 4,
                "title": "الاستنارة",
                "description": null,
                "video_id": 916819162,
                "length": "00:00:00",
                "user_notes_count": 0,
                "is_watched": false,
                "watched_id": null,
                "stopped_in": null,
                "is_promotional": false
            },
            {
                "id": "645e6050-d6d5-11ee-8541-5546f6c6e811",
                "number": 5,
                "title": "الرحلات الروحية",
                "description": null,
                "video_id": 916821611,
                "length": "00:00:00",
                "user_notes_count": 0,
                "is_watched": false,
                "watched_id": null,
                "stopped_in": null,
                "is_promotional": false
            },
            {
                "id": "64610890-d6d5-11ee-9073-05d9a8e133df",
                "number": 6,
                "title": "الطقوس الروحية",
                "description": null,
                "video_id": 916823130,
                "length": "00:00:00",
                "user_notes_count": 0,
                "is_watched": true,
                "watched_id": "9dd2d3c0-ed77-11ef-bd61-3babb48718f0",
                "stopped_in": null,
                "is_promotional": false
            },
            {
                "id": "6463e7b0-d6d5-11ee-bc8f-75ad08019270",
                "number": 7,
                "title": "العقد الصوتي",
                "description": null,
                "video_id": 916828055,
                "length": "00:00:00",
                "user_notes_count": 0,
                "is_watched": true,
                "watched_id": "dfda49c0-ed80-11ef-98f6-cb95b8669f47",
                "stopped_in": null,
                "is_promotional": false
            },
            {
                "id": "64668e60-d6d5-11ee-b8e2-69ee96d6ee37",
                "number": 8,
                "title": "طبقات الروح",
                "description": null,
                "video_id": 916829316,
                "length": "00:00:00",
                "user_notes_count": 0,
                "is_watched": false,
                "watched_id": null,
                "stopped_in": null,
                "is_promotional": false
            },
            {
                "id": "64694160-d6d5-11ee-8c36-c1a953b92b06",
                "number": 9,
                "title": "عالم الشر",
                "description": null,
                "video_id": 916830032,
                "length": "00:00:00",
                "user_notes_count": 0,
                "is_watched": false,
                "watched_id": null,
                "stopped_in": null,
                "is_promotional": false
            },
            {
                "id": "646c5720-d6d5-11ee-996d-4570f2e7b928",
                "number": 10,
                "title": "الكونداليني",
                "description": null,
                "video_id": 916831993,
                "length": "00:00:00",
                "user_notes_count": 0,
                "is_watched": false,
                "watched_id": null,
                "stopped_in": null,
                "is_promotional": false
            }
        ],
        "unowned_videos": [],
        "video_button_text": "إكمال الدفع",
        "video_button_status": true,
        "attachments": [],
        "attachments_count": 0,
        "seo": {
            "title": "مادة أسرار روحية",
            "description": "...",
            "image": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/21600/3--%D8%A7%D8%B3%D8%B1%D8%A7%D8%B1-%D8%B1%D9%88%D8%AD%D9%8A%D8%A9_%D9%85%D9%82%D8%A7%D8%B3-%D8%A7%D9%84%D9%85%D9%88%D9%82%D8%B9-min.png",
            "type": "courses",
            "locale": "ar_SA",
            "site_name": "Sumaya369",
            "keywords": "الدكتورة سمية الناصر,موقع الدكتورة سمية الناصر,دورات سمية الناصر,مقالات سمية الناصر,سمية الناصر الموقع الرسمي,كتب تتحدث عن الجسد المشاعري,sumaya369,الجسد المشاعري,خريطة المشاعر",
            "author": "الدكتورة سمية الناصر",
            "published_time": "2024-02-29T10:37:29+03:00",
            "modified_time": "2025-02-19T17:14:39+03:00",
            "article_tags": "مفاهيم متوسطة,تطبيقات متوسطة,للجسد الروحي,للجسد الفكري,مادة للتطوير",
            "article_section": "مادة"
        },
        "is_rating_skipped": true,
        "target_audience_description": "<p class=\"ql-align-right\"><br></p>",
        "is_target_audience_active": false,
        "display_before_products": false,
        "display_after_products": false
    },
    "status_code": 200
}

Error Responses​

  • 401 Unauthorized: When trying to access a non-open-source course without authentication
  • 404 Not Found: When the course doesn't exist
  • 410 Gone: When the user's product availability has expired

Get Course Before Products​

Endpoint​

  • Method: GET
  • URL: /v1/customer/before-products/{id}

Returns a list of products that should be completed before starting this course.

Request Headers​

HeaderValueRequired
Content-Typeapplication/jsonYes
Acceptapplication/jsonYes

Path Parameters​

ParameterTypeDescriptionRequired
idstringCourse IDYes

Success Response​

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": [
        {
            "id": "644c9940-d6d5-11ee-9bcd-37caa6e58047",
            "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/21600/3--%D8%A7%D8%B3%D8%B1%D8%A7%D8%B1-%D8%B1%D9%88%D8%AD%D9%8A%D8%A9_%D9%85%D9%82%D8%A7%D8%B3-%D8%A7%D9%84%D9%85%D9%88%D9%82%D8%B9-min.png",
            "name": "أسرار روحية",
            "slug": "أسرار-روحية",
            "videos_count": 10,
            "hide_price": false,
            "price": 978.33,
            "old_price": 978.33,
            "does_has_vat": true,
            "price_with_vat_show": 1125.08,
            "pay_button_title": "أخبرني عند التوفر",
            "pay_button_status": true,
            "has_active_subscribed": false,
            "favorite": null,
            "model_type": "courses"
        },
        {
            "id": "afd749e0-c053-11ee-b1ed-05b1dcd67fc0",
            "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/21244/%D8%B5%D9%88%D8%B1%D8%A92.png",
            "name": "اعداء النجاح",
            "slug": "اعداء-النجاح",
            "videos_count": 11,
            "hide_price": false,
            "price": 369.22,
            "old_price": 369.22,
            "does_has_vat": true,
            "price_with_vat_show": 424.6,
            "pay_button_title": "أضف للسلة",
            "pay_button_status": true,
            "has_active_subscribed": false,
            "favorite": null,
            "model_type": "courses"
        }
    ],
    "status_code": 200
}

Get Course After Products​

Endpoint​

  • Method: GET
  • URL: /v1/customer/after-products/{id}

Returns a list of recommended products to take after completing this course.

Request Headers​

HeaderValueRequired
Content-Typeapplication/jsonYes
Acceptapplication/jsonYes

Path Parameters​

ParameterTypeDescriptionRequired
idstringCourse IDYes

Success Response​

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": [
        {
            "id": "8a620ad0-a5a2-11ee-8c63-07e9c26c60de",
            "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/20786/%D9%85%D8%B5%D8%A7%D8%AF%D8%B1-%D8%A7%D9%84%D8%AB%D8%B1%D8%A7%D8%A1.png",
            "name": "مصادر الثراء",
            "slug": "مصادر-الثراء",
            "videos_count": 8,
            "hide_price": false,
            "price": 333,
            "old_price": 333,
            "does_has_vat": true,
            "price_with_vat_show": 382.95,
            "pay_button_title": "أضف للسلة",
            "pay_button_status": true,
            "has_active_subscribed": false,
            "favorite": null,
            "model_type": "courses"
        }
    ],
    "status_code": 200
}

Endpoint​

  • Method: GET
  • URL: /v1/customer/related-products/{id}

Returns a list of related courses and products.

Request Headers​

HeaderValueRequired
Content-Typeapplication/jsonYes
Acceptapplication/jsonYes

Path Parameters​

ParameterTypeDescriptionRequired
idstringCourse IDYes

Success Response​

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": [
        {
            "id": "fee57500-b67a-11ec-86b8-effe1ae70080",
            "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/812/f807c594--%D9%853.png",
            "name": "ابنوس",
            "slug": "ابنوس",
            "videos_count": 20,
            "hide_price": true,
            "price": "hide_price",
            "old_price": "hide_price",
            "is_purchasable": false,
            "does_has_vat": false,
            "price_with_vat_show": "hide_price",
            "pay_button_title": "أخبرني عند التوفر",
            "pay_button_status": true,
            "has_active_subscribed": false,
            "favorite": null,
            "model_type": "courses",
            "has_available_special_link": true,
            "has_reduced_price": false,
            "tags": [
                {
                    "id": "6d356c70-fb23-11ee-8b8e-f56be7e8889f",
                    "name": "مفاهيم عميقة",
                    "color": null
                },
                {
                    "id": "95318a30-fb23-11ee-86d1-a5ccc3e103dd",
                    "name": "تطبيقات عميقة",
                    "color": null
                },
                {
                    "id": "965e3cc0-fb24-11ee-9658-b558db5ba9ce",
                    "name": "للجسد المشاعري",
                    "color": null
                },
                {
                    "id": "c18a0c70-fb45-11ee-9590-2927458bbee4",
                    "name": "مادة للتنظيف",
                    "color": null
                }
            ],
            "rating": 4.8,
            "ratings_count": "272"
        },
        {
            "id": "f0485b00-b67a-11ec-903a-6f7ee614148f",
            "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/750/9170c850--%D9%85%D9%88%D9%82%D8%B9.png",
            "name": "التعلق",
            "slug": "التعلق",
            "videos_count": 16,
            "hide_price": false,
            "price": 220,
            "old_price": 220,
            "is_purchasable": true,
            "does_has_vat": true,
            "price_with_vat_show": 253,
            "pay_button_title": "أضف للسلة",
            "pay_button_status": true,
            "has_active_subscribed": false,
            "favorite": null,
            "model_type": "courses",
            "has_available_special_link": false,
            "has_reduced_price": false,
            "tags": [
                {
                    "id": "e4b89f90-fb24-11ee-b8da-85ef5b834ca6",
                    "name": "مفاهيم متوسطة",
                    "color": null
                },
                {
                    "id": "d41a8580-fb24-11ee-9672-ad75a3f41a4a",
                    "name": "تطبيقات متوسطة",
                    "color": null
                },
                {
                    "id": "965e3cc0-fb24-11ee-9658-b558db5ba9ce",
                    "name": "للجسد المشاعري",
                    "color": null
                },
                {
                    "id": "c18a0c70-fb45-11ee-9590-2927458bbee4",
                    "name": "مادة للتنظيف",
                    "color": null
                }
            ],
            "rating": 4.8,
            "ratings_count": "177"
        }
    ],
    "status_code": 200
}

Example Implementation Flow​

  1. Course Listing

    • Application sends request to /v1/customer/courses
    • Optional query parameters:
      • Filter by category
      • Filter by material types
      • Filter by body types
      • Filter by awareness levels
      • Filter by price reductions
      • Specify number of courses per page
    • Display courses with pagination
    • Show course details including:
      • Price with VAT calculations
      • Video counts
      • Course rating and reviews count
    • Show SEO metadata

  2. Single Course View

    • User selects a course
    • Application sends request to /v1/customer/courses/{id_or_slug}
    • Display full course content including:
      • Basic Information:
        • Course name and description
        • Special ID (if available)
        • Poster image
      • Pricing Information:
        • Current price and old price
        • VAT status and price with VAT
        • Certificate and summary prices
      • Content Information:
        • Video count and watched videos
        • Course length and duration
        • Attachments count and list
      • Interactive Features:
        • Rating and commenting capabilities
        • Purchase and subscription status
        • Download permissions for summary/certificate
      • Additional Features:
        • Target audience information
        • Related courses
        • Course notes
        • Video access controls
      • UI Elements:
        • Pay button status and title
        • Video button status and text
      • SEO Information:
        • Title, description, and keywords

  3. Course Learning Path

    • Get prerequisite courses via /v1/customer/before-products/{id}
    • Get follow-up courses via /v1/customer/after-products/{id}
    • Get related courses via /v1/customer/related-products/{id}
    • Display learning path visualization showing:
      • Prerequisites that should be completed first
      • Current course
      • Recommended next steps
      • Related courses for broader learning

Key Considerations​

  • Implement response caching for unauthorized users
  • Handle both web and mobile platform-specific responses
  • Manage course visibility based on:
    • User authentication
    • Open source status
    • Special ID access
    • Product availability expiration
  • Calculate and display accurate pricing including:
    • Current and old prices
    • VAT calculations
    • Certificate and summary prices
    • Special pricing conditions (hide price)
  • Track user interaction states:
    • Favorites
    • Ratings and comments
    • Video progress
    • Download permissions
  • Handle course access based on:
    • Authentication status
    • Subscription status
    • Purchase eligibility
    • Instant subscription availability
  • Manage UI states through:
    • Button visibility and text
    • Access permissions
    • Download capabilities
    • Rating and comment permissions