FAQ

This section covers the API endpoints for managing FAQs (Frequently Asked Questions). These endpoints allow administrators to create, view, update and delete FAQ entries with associated categories and tags.

List FAQs

Retrieve a paginated list of FAQs.

GET /v1/admin/faqs

Query Parameters

Parameter	Type	Description
filter[section_type]	string	Filter by section type
search_text	string	Search in question text
sort	string	Sort field (priority)
per_page	integer	Number of items per page (default: 15)
list	boolean	If true, returns unpaginated list of all FAQs

Response

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": {
        "current_page": 1,
        "first_page_url": "http://192.168.0.139:8080/v1/admin/faqs?page=1",
        "from": 1,
        "last_page": 4,
        "last_page_url": "http://192.168.0.139:8080/v1/admin/faqs?page=4",
        "links": [
            {
                "url": null,
                "label": "&laquo; السابق",
                "active": false
            },
            {
                "url": "http://192.168.0.139:8080/v1/admin/faqs?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": "http://192.168.0.139:8080/v1/admin/faqs?page=2",
                "label": "2",
                "active": false
            },
            {
                "url": "http://192.168.0.139:8080/v1/admin/faqs?page=3",
                "label": "3",
                "active": false
            },
            {
                "url": "http://192.168.0.139:8080/v1/admin/faqs?page=4",
                "label": "4",
                "active": false
            },
            {
                "url": "http://192.168.0.139:8080/v1/admin/faqs?page=2",
                "label": "التالي &raquo;",
                "active": false
            }
        ],
        "next_page_url": "http://192.168.0.139:8080/v1/admin/faqs?page=2",
        "path": "http://192.168.0.139:8080/v1/admin/faqs",
        "per_page": 15,
        "prev_page_url": null,
        "to": 15,
        "total": 51,
        "faqs": [
            {
                "id": "e45f9100-39c5-11ee-9f2f-25f235d08993",
                "question": "س4/هل مواد الدكتورة سمية الناصر علاجية ؟",
                "answer": "<p>لا تقدم الدكتورة سمية أي مواد علاجية ، جميع مواد الدكتورة سمية الناصر لا تُعالج ، وليست مخصصة لأي حالات مرضية.</p>",
                "faq_category_name": null,
                "is_available": true,
                "priority": 4,
                "user_id": "e4c27000-1be5-11ee-9e39-57c149f8fca3",
                "created_at": "2025-01-01 00:00:00",
                "updated_at": "2025-01-01 00:00:00"
            },
            {
                "id": "bfae9440-39c5-11ee-a4db-691df676ead9",
                "question": "س3/هل يمكنني الحصول على شهادة عند الانتهاء من حضور أحد المواد ؟",
                "answer": "<p class=\"ql-align-right\">لا ، نحن لا نقدم أي شهادة اجتياز للمادة ولا أي نوع آخر من الشهادات.</p>",
                "faq_category_name": null,
                "is_available": true,
                "priority": 3,
                "user_id": "e4c27000-1be5-11ee-9e39-57c149f8fca3",
                "created_at": "2025-01-01 00:00:00",
                "updated_at": "2025-01-01 00:00:00"
            },
            {
                "id": "972286f0-39c5-11ee-ab8a-57fca11bc8cd",
                "question": "س2/ هل تحتوي موادكم على مستويات تعليمية حسب التصنيف السعودي الموحد ؟",
                "answer": "<p class=\"ql-align-right\">لا ، نحن لا نقدم أي مستويات تعليمية سواء ضمن التصنيف السعودي الموحد أو أي تصنيف تعليمي آخر</p>",
                "faq_category_name": null,
                "is_available": true,
                "priority": 2,
                "user_id": "e4c27000-1be5-11ee-9e39-57c149f8fca3",
                "created_at": "2025-01-01 00:00:00",
                "updated_at": "2025-01-01 00:00:00"
            },
            {
                "id": "6c49aa00-39c5-11ee-a2e2-fdf77cb51b82",
                "question": "س1/ هل المواد المقدمة هي مواد تعليمية ؟",
                "answer": "<p><span style=\"background-color: rgb(246, 245, 247);\">لا ، نحن لا نقدم مواد تعليمية ، نحن نقدم مواد لمشاركة نمط الحياة .&nbsp;</span></p><p class=\"ql-align-right\"><br></p>",
                "faq_category_name": null,
                "is_available": true,
                "priority": 1,
                "user_id": "e4c27000-1be5-11ee-9e39-57c149f8fca3",
                "created_at": "2025-01-01 00:00:00",
                "updated_at": "2025-01-01 00:00:00"
            },
            {
                "id": "e11d2eb0-f8a2-11ed-8e47-25f7b3c7b5a9",
                "question": "4) في اي وقت ينتهي اشتراكي في المادة ؟",
                "answer": "<p>تنتهي مشاهدة المادة في الساعة 24:00 بتوقيت السعودية  .</p><p class=\"ql-align-right\"><br></p>",
                "faq_category_name": "استفسارات عامة",
                "is_available": true,
                "priority": 47,
                "user_id": "158e72ff-9a1d-42f9-8345-99300fee6313",
                "created_at": "2025-01-01 00:00:00",
                "updated_at": "2025-01-01 00:00:00"
            },
            {
                "id": "27b3c680-d9c3-11ed-baee-6555775af199",
                "question": "7) أين أجد مادة الموسيقى التحولية ؟",
                "answer": "<p class=\"ql-align-right\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">الموسيقى التحولية توجد ضمن باقة التنظيفات العميقة فقط ولا تباع منفردة .</span></p>",
                "faq_category_name": "المواد – المحتوى و التطبيق",
                "is_available": true,
                "priority": 20,
                "user_id": "158e72ff-9a1d-42f9-8345-99300fee6313",
                "created_at": "2025-01-01 00:00:00",
                "updated_at": "2025-01-01 00:00:00"
            },
            {
                "id": "0184c340-d9c3-11ed-9163-af8d8ab79174",
                "question": "6) أين أجد مفكرة الشهر؟",
                "answer": "<p class=\"ql-align-right\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">يمكنك إيجاد المفكرة في :</span></p><p class=\"ql-align-right\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">1- صفحة </span><a href=\"https://sumaya369.net/events\" rel=\"noopener noreferrer\" target=\"_blank\" style=\"color: rgb(0, 0, 0); display: inline !important;\">أحداث الشهر</a> </p><p class=\"ql-align-right\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">2- مواد الشهر  </span></p>",
                "faq_category_name": "المواد – المحتوى و التطبيق",
                "is_available": true,
                "priority": 19,
                "user_id": "158e72ff-9a1d-42f9-8345-99300fee6313",
                "created_at": "2025-01-01 00:00:00",
                "updated_at": "2025-01-01 00:00:00"
            },
            {
                "id": "c6f5fdd0-d9c2-11ed-823c-a3c769b77527",
                "question": "5) هل يوجد ترتيب معين لباقة التنظيفات العميقة؟",
                "answer": "<p class=\"ql-direction-rtl\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">نعم ، بحسب الترتيب أدناه :</span></p><p class=\"ql-direction-rtl\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">1) السول ديتوكس مع الموسيقى التحولية في نفس الوقت</span></p><p class=\"ql-direction-rtl\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">2) الوعي الطفولي مع التنفس في نفس الوقت</span></p><p class=\"ql-direction-rtl\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">3) تنظيف دائرة المشاعر</span></p><p class=\"ql-direction-rtl\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">4) تنظيف الجسد الفكري</span></p><p>5) تنظيف الاختيارات</p><p>6) تنظيف الكارما</p><p>7) أسرار التنظيف</p><p><br></p><p>يلزم عند البدء بالتنظيف أن يكون تطبيق التمارين بشكل متتالي ومتواصل حتى يتم الحصول على النتائج المرجوة من المادة.</p><p class=\"ql-align-right\"><span style=\"background-color: rgb(248, 248, 248); color: rgb(29, 28, 29);\">نتمنى لكم المزيد من قفزات الوعي</span></p>",
                "faq_category_name": "المواد – المحتوى و التطبيق",
                "is_available": true,
                "priority": 18,
                "user_id": "158e72ff-9a1d-42f9-8345-99300fee6313",
                "created_at": "2025-01-01 00:00:00",
                "updated_at": "2025-01-01 00:00:00"
            },
            {
                "id": "af288d20-d9c2-11ed-9f00-f56ace92edc2",
                "question": "4) هل يوجد ترتيب معين لباقة تنظيف المشاعر ؟",
                "answer": "<p class=\"ql-direction-rtl\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">نعم ،&nbsp;</span></p><p class=\"ql-direction-rtl\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">1) الثقة بالنفس ( العار )</span></p><p class=\"ql-direction-rtl\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">2) التأنيب&nbsp;</span></p><p class=\"ql-direction-rtl\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">3) اليأس</span></p><p class=\"ql-direction-rtl\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">4) الحزن&nbsp;</span></p><p class=\"ql-direction-rtl\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">5) الخوف&nbsp;</span></p><p class=\"ql-direction-rtl\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">6) الغضب </span></p><p class=\"ql-align-right\"><br></p>",
                "faq_category_name": "المواد – المحتوى و التطبيق",
                "is_available": true,
                "priority": 17,
                "user_id": "158e72ff-9a1d-42f9-8345-99300fee6313",
                "created_at": "2025-01-01 00:00:00",
                "updated_at": "2025-01-01 00:00:00"
            },
            {
                "id": "8118f4c0-d9c2-11ed-9e36-e979a9bfeb85",
                "question": "4) كم يستغرق قبول طلبي للانضمام إلى خصم الطلاب بعد التقديم ؟",
                "answer": "<p class=\"ql-direction-rtl\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">من 2 إلى 3 أيام عمل .</span></p><p class=\"ql-direction-rtl\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">قد تتأثر المدة وفقاً لتقديمك كافة البيانات المطلوبة بشكل صحيح .</span></p>",
                "faq_category_name": "النقاط والمستويات",
                "is_available": true,
                "priority": 43,
                "user_id": "158e72ff-9a1d-42f9-8345-99300fee6313",
                "created_at": "2025-01-01 00:00:00",
                "updated_at": "2025-01-01 00:00:00"
            },
            {
                "id": "6795df20-d9c2-11ed-9b79-63c13bd33d01",
                "question": "3) متى يتم احتساب النقاط ؟",
                "answer": "<p class=\"ql-align-right\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">يتم اكتساب النقاط بعد إتمام أي طلب مدفـوع على الموقع .</span></p>",
                "faq_category_name": "النقاط والمستويات",
                "is_available": true,
                "priority": 42,
                "user_id": "158e72ff-9a1d-42f9-8345-99300fee6313",
                "created_at": "2025-01-01 00:00:00",
                "updated_at": "2025-01-01 00:00:00"
            },
            {
                "id": "516a9d80-d9c2-11ed-8d03-6d5acaa3f573",
                "question": "2) كم عدد النقاط المطلوبة للدخول لكل مستوى ؟",
                "answer": "<p class=\"ql-direction-rtl\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">برونزي : 390</span></p><p class=\"ql-direction-rtl\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">فضي : 600</span></p><p class=\"ql-direction-rtl\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">ذهبي : 800</span></p><p class=\"ql-direction-rtl\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">ماسي : 1200</span></p><p class=\"ql-align-right\"><br></p>",
                "faq_category_name": "النقاط والمستويات",
                "is_available": true,
                "priority": 41,
                "user_id": "158e72ff-9a1d-42f9-8345-99300fee6313",
                "created_at": "2025-01-01 00:00:00",
                "updated_at": "2025-01-01 00:00:00"
            },
            {
                "id": "2f3fc0f0-d9c2-11ed-ab52-3bb143254758",
                "question": "1) كيف يتم احتساب النقاط للعملاء المميزين ؟",
                "answer": "<p class=\"ql-direction-rtl\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">بدايةً ، يكون المستخدم في المستوى الافتراضي ( نقاطي ) بعد إنشاء الحساب مباشرة .&nbsp;</span></p><p class=\"ql-direction-rtl\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">ثم يبدأ بجمع النقاط عند كل طلب مدفـوع على الموقع .</span></p><p class=\"ql-direction-rtl\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">- يتم الدخول للمستويات المتقدمة بعد إكمال جمع النقاط المحددة لكل مستوى :&nbsp;</span></p><p class=\"ql-direction-rtl\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">البرونزي : 390 نقطة</span></p><p class=\"ql-direction-rtl\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">الفضي : 600 نقطة</span></p><p class=\"ql-direction-rtl\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">الذهبي : 800 نقطة&nbsp;</span></p><p class=\"ql-direction-rtl\"><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">الماسي : 1200 نقطة </span></p>",
                "faq_category_name": "النقاط والمستويات",
                "is_available": true,
                "priority": 40,
                "user_id": "158e72ff-9a1d-42f9-8345-99300fee6313",
                "created_at": "2025-01-01 00:00:00",
                "updated_at": "2025-01-01 00:00:00"
            },
            {
                "id": "04527e40-cd2d-11ed-af19-b7731dcb889c",
                "question": "2) لا أستطيع الحصول على السجل الأكاديمي ماذا أفعل ؟",
                "answer": "<p>يمكنك إرفاق مستند رسمي يثبت التحاقك بالجهة التعليمية&nbsp;.</p>",
                "faq_category_name": "فئة خصم الطلاب",
                "is_available": true,
                "priority": 39,
                "user_id": "158e72ff-9a1d-42f9-8345-99300fee6313",
                "created_at": "2025-01-01 00:00:00",
                "updated_at": "2025-01-01 00:00:00"
            },
            {
                "id": "c7bebaa0-cd2b-11ed-a35e-5d1d7324ab57",
                "question": "1) ما هو السجل الأكاديمي المطلوب إرفاقه في نموذج تقديم ( فئة خصم الطلاب ) ؟ وكيف يمكنني الحصول عليه ؟",
                "answer": "<p>1- هو بيان يوضح سير الطالب الدراسي، ويشمل المقررات التي يدرسها في كل فصل دراسي .</p><p><br></p><p>2- يمكنك التواصل مع جهة التعليم الخاصة بك للحصول على السجل الأكاديمي&nbsp;.</p><p class=\"ql-align-right\"><br></p>",
                "faq_category_name": "فئة خصم الطلاب",
                "is_available": true,
                "priority": 38,
                "user_id": "158e72ff-9a1d-42f9-8345-99300fee6313",
                "created_at": "2025-01-01 00:00:00",
                "updated_at": "2025-01-01 00:00:00"
            }
        ]
    },
    "status_code": 200
}

Create FAQ

Create a new FAQ entry.

POST /v1/admin/faqs

Request Parameters

Parameter	Type	Description	Validation Rules
question	string	FAQ question text	Required, 3-255 characters
answer	string	FAQ answer text	Required, min 3 characters
faq_category_id	string	Category UUID	Required, must exist in faq_categories
is_available	boolean	Visibility status	Required, true/false
priority	integer	Display order	Optional, greater than 0
tag_names	array	Array of tag names	Optional
tag_names.*	string	Individual tag name	3-255 characters

Response

{
    "success": true,
    "message": "تم حفظ البيانات بنجاح.",
    "data": {
        "id": "a7003eb0-058c-11f0-a744-9f41bda6d73c",
        "question": "احداً ويستعين على ذلك الزاد وأكل منه. فلما ذاقه.؟",
        "answer": "يحتاج إلى بيان أكثر من استعداد الجسم",
        "faq_category_id": "882267e0-d9c0-11ed-b82c-f36eb8a9be8a",
        "faq_category_name": "النقاط والمستويات",
        "is_available": true,
        "user_id": "3a0a4810-dab4-11ec-8e1b-cb15cec27c77",
        "priority": "50",
        "tag_names": [
            "الصدمة"
        ],
        "created_at": "2025-03-20 16:10:10",
        "updated_at": "2025-03-20 16:10:10",
        "tags": [
            {
                "id": "8e12aa80-058b-11f0-8565-0564f783faee",
                "name": "الصدمة",
                "color": "#98DEDE",
                "pivot": {
                    "taggable_type": "App\\Models\\FAQ",
                    "taggable_id": "a7003eb0-058c-11f0-a744-9f41bda6d73c",
                    "tag_id": "8e12aa80-058b-11f0-8565-0564f783faee"
                },
                "created_at": "2025-03-20 16:02:19",
                "updated_at": "2025-03-20 16:02:19"
            }
        ],
        "faq_categories": [
            "التسجيل في الموقع",
            "الاشتراك في المواد",
            "المواد – المحتوى و التطبيق",
            "نافـا",
            "الدفع",
            "التقسيط",
            "النقاط والمستويات",
            "استفسارات عامة",
            "فئة خصم الطلاب",
            "الكون"
        ]
    },
    "status_code": 200
}

Get FAQ

Retrieve a specific FAQ entry by its ID.

GET /v1/admin/faqs/{id}

Response

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": {
        "id": "e45f9100-39c5-11ee-9f2f-25f235d08993",
        "question": "س4/هل مواد الدكتورة سمية الناصر علاجية ؟",
        "answer": "<p>لا تقدم الدكتورة سمية أي مواد علاجية ، جميع مواد الدكتورة سمية الناصر لا تُعالج ، وليست مخصصة لأي حالات مرضية.</p>",
        "faq_category_id": "7c745ee0-39bd-11ee-a2bc-bf1e549fbddb",
        "faq_category_name": null,
        "is_available": true,
        "user_id": "e4c27000-1be5-11ee-9e39-57c149f8fca3",
        "priority": 4,
        "tag_names": [],
        "created_at": "2023-08-13 13:40:59",
        "updated_at": "2023-08-13 13:41:46",
        "tags": [],
        "faq_categories": [
            "التسجيل في الموقع",
            "الاشتراك في المواد",
            "المواد – المحتوى و التطبيق",
            "نافـا",
            "الدفع",
            "التقسيط",
            "النقاط والمستويات",
            "استفسارات عامة",
            "فئة خصم الطلاب",
            "الكون"
        ]
    },
    "status_code": 200
}

Update FAQ

Update an existing FAQ entry.

PATCH /v1/admin/faqs/{id}

Request Parameters

Parameter	Type	Description	Validation Rules
question	string	FAQ question text	3-255 characters
answer	string	FAQ answer text	Min 3 characters
faq_category_id	string	Category UUID	Must exist in faq_categories
is_available	boolean	Visibility status	true/false
priority	integer	Display order	Greater than 0
tag_names	array	Array of tag names	Optional
tag_names.*	string	Individual tag name	3-255 characters

Response

{
    "success": true,
    "message": "تم تحديث البيانات بنجاح.",
    "data": {
        "id": "a7003eb0-058c-11f0-a744-9f41bda6d73c",
        "question": "احداً ويستعين على ذلك الزاد وأكل منه. فلما ذاقه.؟",
        "answer": "يحتاج إلى بيان أكثر من استعداد الجسم",
        "faq_category_id": "882267e0-d9c0-11ed-b82c-f36eb8a9be8a",
        "faq_category_name": "النقاط والمستويات",
        "is_available": true,
        "user_id": "3a0a4810-dab4-11ec-8e1b-cb15cec27c77",
        "priority": "30",
        "tag_names": [
            "الصدمة"
        ],
        "created_at": "2025-03-20 16:10:10",
        "updated_at": "2025-03-20 16:10:31",
        "tags": [
            {
                "id": "8e12aa80-058b-11f0-8565-0564f783faee",
                "name": "الصدمة",
                "color": "#98DEDE",
                "pivot": {
                    "taggable_type": "App\\Models\\FAQ",
                    "taggable_id": "a7003eb0-058c-11f0-a744-9f41bda6d73c",
                    "tag_id": "8e12aa80-058b-11f0-8565-0564f783faee"
                },
                "created_at": "2025-03-20 16:02:19",
                "updated_at": "2025-03-20 16:02:19"
            }
        ],
        "faq_categories": [
            "التسجيل في الموقع",
            "الاشتراك في المواد",
            "المواد – المحتوى و التطبيق",
            "نافـا",
            "الدفع",
            "التقسيط",
            "النقاط والمستويات",
            "استفسارات عامة",
            "فئة خصم الطلاب",
            "الكون"
        ]
    },
    "status_code": 200
}

Delete FAQs

Delete one or more FAQ entries.

DELETE /v1/admin/faqs

Request Parameters

Parameter	Type	Description	Validation Rules
ids	array	Array of FAQ UUIDs to delete	Required
ids.*	string	Individual FAQ UUID	Required, valid UUID

Response

{
    "success": true,
    "message": "تم حذف البيانات بنجاح.",
    "data": null,
    "status_code": 200
}

Notes

When creating or updating FAQs, new tags will be created if they don't already exist
The delete endpoint supports batch deletion of multiple FAQs at once

List FAQs​

Query Parameters​

Response​

Create FAQ​

Request Parameters​

Response​

Get FAQ​

Response​

Update FAQ​

Request Parameters​

Response​

Delete FAQs​

Request Parameters​

Response​

Notes​

List FAQs

Query Parameters

Response

Create FAQ

Request Parameters

Response

Get FAQ

Response

Update FAQ

Request Parameters

Response

Delete FAQs

Request Parameters

Response

Notes