Product Request Questions

This section covers the API endpoints for managing product request questions in the admin panel.

List Questions

GET /v1/admin/product-request-questions

Returns a list of product request questions with pagination support.

Query Parameters

Parameter	Type	Description	Validation Rules
search_text	string	Search in questions	Optional
per_page	integer	Number of items per page	Optional, default: 10
active	boolean	Filter by active status	Optional
trashed	boolean	Include trashed items	Optional

Response

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": {
        "current_page": 1,
        "first_page_url": "http://192.168.0.139:8080/v1/admin/product-request-questions?page=1",
        "from": 1,
        "last_page": 1,
        "last_page_url": "http://192.168.0.139:8080/v1/admin/product-request-questions?page=1",
        "links": [
            {
                "url": null,
                "label": "« السابق",
                "active": false
            },
            {
                "url": "http://192.168.0.139:8080/v1/admin/product-request-questions?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "التالي »",
                "active": false
            }
        ],
        "next_page_url": null,
        "path": "http://192.168.0.139:8080/v1/admin/product-request-questions",
        "per_page": 10,
        "prev_page_url": null,
        "to": 10,
        "total": 10,
        "questions": [
            {
                "id": "ab2a0720-cb47-11ef-9504-8d69dc57168c",
                "question": "كم عمرك؟",
                "active": true,
                "is_affected": true,
                "priority": 1
            },
            {
                "id": "b7fefaf0-cb47-11ef-81e4-c922f8a9deca",
                "question": "متى بدأت رحلة تطوير وعيك؟",
                "active": true,
                "is_affected": true,
                "priority": 2
            },
            {
                "id": "bc87d330-cb48-11ef-b664-83157f997e48",
                "question": "ماهي الأجساد المتطورة لديك؟",
                "active": true,
                "is_affected": true,
                "priority": 3
            },
            {
                "id": "d6479cd0-cb48-11ef-9ba3-6b9b80ef289f",
                "question": "هل حصلت على مادة تنظيف الجسد الفكري وانتهيت من تطبيقاتها؟",
                "active": true,
                "is_affected": true,
                "priority": 4
            },
            {
                "id": "e0ed27e0-cb48-11ef-8bc0-fdd743a8a3c2",
                "question": "هل حصلت على مادة تنظيف المستقبل وانتهيت من تطبيقاتها؟",
                "active": true,
                "is_affected": true,
                "priority": 5
            },
            {
                "id": "fbfa4420-cb48-11ef-bf73-471aa8b5b78e",
                "question": "ماهو أكبر تحدي لك في تطوير وعيك؟",
                "active": true,
                "is_affected": false,
                "priority": 6
            },
            {
                "id": "04dfe5e0-cb49-11ef-b69c-db74d8751657",
                "question": "ما هو الشعور الذي أنت فيه أغلب الوقت؟",
                "active": true,
                "is_affected": false,
                "priority": 7
            },
            {
                "id": "0d9109c0-cb49-11ef-b22b-956dbab2c47c",
                "question": "هل تعرف رسالة روحك؟",
                "active": true,
                "is_affected": false,
                "priority": 8
            },
            {
                "id": "151ad000-cb49-11ef-8435-570881204b7d",
                "question": "من هم المدربين الذين ساهموا في تطوير وعيك؟",
                "active": true,
                "is_affected": false,
                "priority": 9
            },
            {
                "id": "1db15fc0-cb49-11ef-b840-39d8c20d2f20",
                "question": "ما هي المجالات التي تحتاج أن تطور نفسك فيها؟",
                "active": true,
                "is_affected": false,
                "priority": 10
            }
        ]
    },
    "status_code": 200
}

Get Question Details

GET /v1/admin/product-request-questions/{id}

Returns details of a specific product request question.

Response

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": {
        "id": "ab2a0720-cb47-11ef-9504-8d69dc57168c",
        "question": "كم عمرك؟",
        "active": true,
        "priority": 1,
        "is_affected": true,
        "has_correct_answer": true,
        "type": 2,
        "correct_answer_count": null,
        "answers": [
            {
                "id": "3ef6c480-cb49-11ef-9337-f3b6573a1903",
                "answer": "أقل من 18",
                "active": true,
                "is_correct_answer": false,
                "product_request_question_id": "ab2a0720-cb47-11ef-9504-8d69dc57168c"
            },
            {
                "id": "4730db80-cb49-11ef-8e91-a556793862e5",
                "answer": "أكبر من 18",
                "active": true,
                "is_correct_answer": true,
                "product_request_question_id": "ab2a0720-cb47-11ef-9504-8d69dc57168c"
            }
        ]
    },
    "status_code": 200
}

Create Question

POST /v1/admin/product-request-questions

Creates a new product request question.

Request Body

Parameter	Type	Description	Validation Rules
question	string	Question text	Required, min: 3, max: 255
active	boolean	Question active status	Optional, values: true/false
priority	integer	Display priority	Optional, greater than 0
is_affected	boolean	Affected status	Optional, values: true/false
has_correct_answer	boolean	Has correct answer	Optional, values: true/false
type	string	Question type	Optional, values from ProductRequestQuestionTypes
correct_answer_count	integer	Number of correct answers	Required if type is checkbox, greater than 0

Response

{
    "success": true,
    "message": "تم حفظ البيانات بنجاح.",
    "data": {
        "id": "1db15fc0-cb49-11ef-b840-39d8c20d2f20",
        "question": "ما هي المجالات التي تحتاج أن تطور نفسك فيها؟",
        "active": true,
        "priority": 10,
        "is_affected": false,
        "has_correct_answer": false,
        "type": 1,
        "correct_answer_count": null,
        "answers": []
    },
    "status_code": 200
}

Update Question

PATCH /v1/admin/product-request-questions/{id}

Updates an existing product request question.

Request Body

Parameter	Type	Description	Validation Rules
question	string	Question text	Optional, min: 3, max: 255
active	boolean	Question active status	Optional, values: true/false
priority	integer	Display priority	Optional, greater than 0
is_affected	boolean	Affected status	Optional, values: true/false
has_correct_answer	boolean	Has correct answer	Optional, values: true/false
type	string	Question type	Optional, values from ProductRequestQuestionTypes (text, boolean, checkboks, number)
correct_answer_count	integer	Number of correct answers	Required if type is checkbox, greater than 0

Response

{
    "success": true,
    "message": "تم تحديث البيانات بنجاح.",
    "data": {
        "id": "1db15fc0-cb49-11ef-b840-39d8c20d2f20",
        "question": "ما هي المجالات التي تحتاج أن تطور نفسك فيها؟",
        "active": true,
        "priority": 10,
        "is_affected": false,
        "has_correct_answer": false,
        "type": 1,
        "correct_answer_count": "3",
        "answers": []
    },
    "status_code": 200
}

Delete Questions

DELETE /v1/admin/product-request-questions

Deletes multiple product request questions by their IDs.

Request Body

Parameter	Type	Description	Validation Rules
ids	array	Array of question IDs to delete	Required
ids.*	string	Question UUID	Required, UUID format, must exist

Response

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

Notes

• Results are sorted by priority by default
• The list endpoint supports filtering by active status and trashed items
• Search functionality is available for question text
• When type is not checkbox, correct_answer_count will be set to null