Customer Desires

This section covers the API endpoints for managing customer desires in the admin panel.

List Customer Desires

GET /v1/admin/customer/{id}/desires

Returns a paginated list of desires for a specific customer.

Query Parameters

Parameter	Type	Description
search_text	string	Search desires by name
sort	string	Sort by field (name)
per_page	integer	Number of items per page. Defaults to 10
list	boolean	Return simplified list format

Response

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": {
        "current_page": 1,
        "first_page_url": "http://192.168.0.139:8080/v1/admin/customers/d8332950-d9b5-11ec-8b58-ed003ada5998/desires?page=1",
        "from": 1,
        "last_page": 1,
        "last_page_url": "http://192.168.0.139:8080/v1/admin/customers/d8332950-d9b5-11ec-8b58-ed003ada5998/desires?page=1",
        "links": [
            {
                "url": null,
                "label": "« السابق",
                "active": false
            },
            {
                "url": "http://192.168.0.139:8080/v1/admin/customers/d8332950-d9b5-11ec-8b58-ed003ada5998/desires?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "التالي »",
                "active": false
            }
        ],
        "next_page_url": null,
        "path": "http://192.168.0.139:8080/v1/admin/customers/d8332950-d9b5-11ec-8b58-ed003ada5998/desires",
        "per_page": 10,
        "prev_page_url": null,
        "to": 10,
        "total": 10,
        "desires": [
            {
                "id": "0416c790-b2b7-11ed-9881-c159dbdc2534",
                "name": "الدماغ الرئيسي",
                "poster": "http://192.168.0.139:8080/storage/637/الدماغ-الرئيسي-موقع.png",
                "is_deserve": false
            },
            {
                "id": "49cbf6c0-b2b7-11ed-9a2b-e57c29ff6ad3",
                "name": "غداء منتصف الليل",
                "poster": "http://192.168.0.139:8080/storage/23144/غداء-منتصف-الليل--موقع.png",
                "is_deserve": false
            },
            {
                "id": "6cfce970-b2b7-11ed-9224-853b3d81121e",
                "name": "دايزي- الوعي الزواجي",
                "poster": "http://192.168.0.139:8080/storage/23743/دايزي-الوعي-الزواجي.png",
                "is_deserve": false
            },
            {
                "id": "6dcb56b0-b2b7-11ed-a7f2-3546abbc38eb",
                "name": "تنظيف المستقبل",
                "poster": "http://192.168.0.139:8080/storage/26298/1--تنظيف-المستقبل.jpg",
                "is_deserve": false
            },
            {
                "id": "6e8455a0-b2b7-11ed-9438-29cf63a7f65f",
                "name": "الحياة السرية للبشر",
                "poster": "http://192.168.0.139:8080/storage/23145/الحياة-السرية-للبشر-موقع-.png",
                "is_deserve": false
            },
            {
                "id": "6f810bc0-b2b7-11ed-9cde-2f67c6c7cf77",
                "name": "ابنوس",
                "poster": "http://192.168.0.139:8080/storage/26295/ابنوس.jpg",
                "is_deserve": false
            },
            {
                "id": "6fe61460-b2b7-11ed-a89b-458f68de1d7b",
                "name": "قانون التجرد",
                "poster": "http://192.168.0.139:8080/storage/22674/1--قانون-التجرد.png",
                "is_deserve": false
            },
            {
                "id": "71829710-b2b7-11ed-a035-8f62cebba08f",
                "name": "أسرار النشوة",
                "poster": "http://192.168.0.139:8080/storage/24345/أسرار-النشوة.png",
                "is_deserve": false
            },
            {
                "id": "d3975b40-b2b7-11ed-8235-d1cc4c50045a",
                "name": "الخوف",
                "poster": "http://192.168.0.139:8080/storage/28910/1--الخوف.jpg",
                "is_deserve": false
            },
            {
                "id": "0871d3d0-b2b8-11ed-b97e-c1a3f75b8cee",
                "name": "قانون السعي",
                "poster": "http://192.168.0.139:8080/storage/21263/7--قانون-السعي.png",
                "is_deserve": true
            }
        ]
    },
    "status_code": 200
}

List Available Desires

GET /v1/admin/desires

Returns a simplified list of all available desires without pagination.

Response

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": {
        "desires": [
            {
                "id": "3c54e160-b5c5-11ed-8fea-db88be5b4c86",
                "name": "الخط الزمني",
                "poster": "http://192.168.0.139:8080/storage/22191/4--الخط-الزمني(الموقع).png"
            },
            {
                "id": "569ba740-4700-11ee-9a7b-11b6864f4035",
                "name": "نداء الاثير",
                "poster": "http://192.168.0.139:8080/storage/24886/نداء-الأثير.png"
            },
            {
                "id": "1c2f2790-b67b-11ec-b199-674535ca9ad6",
                "name": "رمضان ريكونكـت",
                "poster": "http://192.168.0.139:8080/storage/21605/2--رمضان-ريكونكت_مقاس-الموقع-min.png"
            },
            {
                "id": "e4b4d1f0-b67a-11ec-af65-6bb47f5712ac",
                "name": "الفرح",
                "poster": "http://192.168.0.139:8080/storage/24347/الفرح.png"
            },
        ]
    },
    "status_code": 200
}

Create Customer Desire

POST /v1/admin/customer/{id}/desires

Create a new desire for a specific customer.

Request Body

Parameter	Type	Description
id	string	Required. UUID of the desire to create

Response

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

Delete Customer Desires

DELETE /v1/admin/customer/{id}/desires

Delete one or more desires for a specific customer.

Request Body

Parameter	Type	Description
ids	array	Required. Array of desire UUIDs to delete
ids.*	string	Required. UUID format

Response

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

Authorization

All customer desires management endpoints require admin authorization. The user must have the appropriate permissions to perform these operations.

Notes

• Customer must have a valid GAR (Group Application Request) to create or delete desires
• Cannot delete desires that have already been deserved (deserved_at is not null)
• Desires are linked to courses in the 'available-desires' category