Favorite
This section covers the API endpoints for managing favorites in the admin panel.
List Favorites
GET /v1/admin/favorites
Returns a paginated list of all favorites.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
sort | string | Sort direction (asc or desc). Defaults to desc |
orderBy | string | Field to sort by. Available fields: customer, favoriteable |
per_page | integer | Number of items per page. Defaults to 10 |
search_text | string | Search favorites by customer username, email, or favoriteable name/title |
filter[customer_email] | string | Filter by customer email |
filter[favoriteable] | string | Filter by favoriteable type |
Response
{
"success": true,
"message": "تم جلب البيانات بنجاح.",
"data": {
"current_page": 1,
"first_page_url": "http://testing-api.sumaya369.net/v1/admin/favorites?page=1",
"from": 1,
"last_page": 5073,
"last_page_url": "http://testing-api.sumaya369.net/v1/admin/favorites?page=5073",
"links": [
{
"url": null,
"label": "« السابق",
"active": false
},
{
"url": "http://testing-api.sumaya369.net/v1/admin/favorites?page=1",
"label": "1",
"active": true
},
{
"url": "http://testing-api.sumaya369.net/v1/admin/favorites?page=2",
"label": "2",
"active": false
},
{
"url": "http://testing-api.sumaya369.net/v1/admin/favorites?page=3",
"label": "3",
"active": false
},
{
"url": "http://testing-api.sumaya369.net/v1/admin/favorites?page=4",
"label": "4",
"active": false
},
{
"url": "http://testing-api.sumaya369.net/v1/admin/favorites?page=5",
"label": "5",
"active": false
},
{
"url": "http://testing-api.sumaya369.net/v1/admin/favorites?page=6",
"label": "6",
"active": false
},
{
"url": "http://testing-api.sumaya369.net/v1/admin/favorites?page=7",
"label": "7",
"active": false
},
{
"url": "http://testing-api.sumaya369.net/v1/admin/favorites?page=8",
"label": "8",
"active": false
},
{
"url": "http://testing-api.sumaya369.net/v1/admin/favorites?page=9",
"label": "9",
"active": false
},
{
"url": "http://testing-api.sumaya369.net/v1/admin/favorites?page=10",
"label": "10",
"active": false
},
{
"url": null,
"label": "...",
"active": false
},
{
"url": "http://testing-api.sumaya369.net/v1/admin/favorites?page=5072",
"label": "5072",
"active": false
},
{
"url": "http://testing-api.sumaya369.net/v1/admin/favorites?page=5073",
"label": "5073",
"active": false
},
{
"url": "http://testing-api.sumaya369.net/v1/admin/favorites?page=2",
"label": "التالي »",
"active": false
}
],
"next_page_url": "http://testing-api.sumaya369.net/v1/admin/favorites?page=2",
"path": "http://testing-api.sumaya369.net/v1/admin/favorites",
"per_page": 10,
"prev_page_url": null,
"to": 10,
"total": 50728,
"favorites": [
{
"id": "7ce8c300-03e8-11f0-9b8e-ffbe219cf42f",
"favoriteable_id": "b7f77b70-6f16-11ed-a597-b56bc8f8c67e",
"favoriteable_type": "App\\Models\\Course",
"favoriteable_subject": "قفزة 2023",
"favoriteable_poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/6016/%D9%82%D9%81%D8%B2%D8%A9-2023.png",
"customer_email": "fatemaah653@gmail.com",
"customer_username": "dejah86",
"customer_avatar": "https://i.ibb.co/g4BR50S/avatar.png",
"customer_id": "11a56732-feaa-30bd-998c-fe7738544ca7",
"created_at": "2025-03-18"
},
{
"id": "9e3567f0-ff2d-11ef-a6f1-339bed8b456d",
"favoriteable_id": "ef987f80-2ea9-11ee-a25d-4feef67b585b",
"favoriteable_type": "App\\Models\\Course",
"favoriteable_subject": "الغراب الاسود",
"favoriteable_poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/15719/%D8%B5%D9%88%D8%B1%D8%A916.png",
"customer_email": "msadoon47@gmail.com",
"customer_username": "محمد عبدالله",
"customer_avatar": "https://i.ibb.co/g4BR50S/avatar.png",
"customer_id": "8a11c760-1067-11ef-826e-d31875f62d1f",
"created_at": "2025-03-12"
},
{
"id": "86cefad0-ff24-11ef-9821-95796430d3fb",
"favoriteable_id": "b7f77b70-6f16-11ed-a597-b56bc8f8c67e",
"favoriteable_type": "App\\Models\\Course",
"favoriteable_subject": "قفزة 2023",
"favoriteable_poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/6016/%D9%82%D9%81%D8%B2%D8%A9-2023.png",
"customer_email": "developer@sumaya369.net",
"customer_username": "sumaya_content",
"customer_avatar": "https://i.ibb.co/YhTw0wR/7-512.png",
"customer_id": "9f2ecd22-5c07-48ec-9415-2979deec4493",
"created_at": "2025-03-12"
},
{
"id": "d91b85f0-ff23-11ef-9559-3d1971aae36f",
"favoriteable_id": "19ea7880-b67b-11ec-b223-b3816b83703a",
"favoriteable_type": "App\\Models\\Course",
"favoriteable_subject": "عمر الروح",
"favoriteable_poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/21608/12--%D8%B9%D9%85%D8%B1-%D8%A7%D9%84%D8%B1%D9%88%D8%AD-min.png",
"customer_email": "developer@sumaya369.net",
"customer_username": "sumaya_content",
"customer_avatar": "https://i.ibb.co/YhTw0wR/7-512.png",
"customer_id": "9f2ecd22-5c07-48ec-9415-2979deec4493",
"created_at": "2025-03-12"
},
{
"id": "5c5708a0-f315-11ef-8830-c908f76d0944",
"favoriteable_id": "ce31e4d0-fe0b-11ed-8966-83608074a91f",
"favoriteable_type": "App\\Models\\Course",
"favoriteable_subject": "اسئلة الجسد المشاعري",
"favoriteable_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",
"customer_email": "developer@sumaya369.net",
"customer_username": "sumaya_content",
"customer_avatar": "https://i.ibb.co/YhTw0wR/7-512.png",
"customer_id": "9f2ecd22-5c07-48ec-9415-2979deec4493",
"created_at": "2025-02-25"
},
]
},
"status_code": 200
}
Get Favorite Statistics
GET /v1/admin/favorites/statistics
Returns statistics about favorites including total count, most favorited items, and favorites by country.
Response
{
"success": true,
"message": "تم جلب البيانات بنجاح.",
"data": {
"total_favorites": "34.83k",
"most_favorited": [
{
"poster": "http://192.168.0.139:8080/storage/21609/14--عقود-الروح-min.png",
"name": "عقود الروح"
},
{
"poster": "http://192.168.0.139:8080/storage/754/c1a053f9--الانفصال-موقع.png",
"name": "باقة الانفصال"
}
],
"most_favourites_countries": [
{
"name": "ليتوانيا",
"percentage": "13%"
},
{
"name": "ولايات ميكرونيسيا المتحدة",
"percentage": "14%"
},
{
"name": "تركمانستان",
"percentage": "22%"
},
{
"name": "زامبيا",
"percentage": "17%"
}
]
},
"status_code": 200
}
Get Favoriteables List
GET /v1/admin/favorites/favoritables
Returns a list of all items that have been favorited, including courses, ebooks, bundles, articles, and publications.
Response
{
"success": true,
"message": "تم جلب البيانات بنجاح.",
"data": [
{
"id": "204d9ae0-7532-11ed-82db-4994ff7b9907",
"name": "أهداف 2023",
"type": "courses"
},
{
"id": "b7f77b70-6f16-11ed-a597-b56bc8f8c67e",
"name": "قفزة 2023",
"type": "courses"
},
{
"id": "1ab0a790-6f1b-11ed-b447-6d37ecfb06a6",
"name": "حماية الذات",
"type": "courses"
},
{
"id": "16139dc0-b67b-11ec-80bd-69703754a901",
"name": "الرسائل الكونية",
"type": "courses"
},
{
"id": "0e88e000-b67b-11ec-857f-4779cc02f175",
"name": "شفرة كاليوبـي",
"type": "courses"
},
{
"id": "4b12a910-8dc4-11ee-834e-e9639325d547",
"name": "الكبرياء",
"type": "courses"
},
{
"id": "6a9a3cd0-6f1c-11ed-b3bb-b7db1a5a5fb4",
"name": "اليأس",
"type": "courses"
},
{
"id": "19ea7880-b67b-11ec-b223-b3816b83703a",
"name": "عمر الروح",
"type": "courses"
},
{
"id": "ef987f80-2ea9-11ee-a25d-4feef67b585b",
"name": "الغراب الاسود",
"type": "courses"
},
{
"id": "0f35b180-b67b-11ec-913b-27291b8dcad2",
"name": "قانون المسؤولية",
"type": "courses"
},
{
"id": "b6017100-26a4-11ed-99aa-453de54199f1",
"name": "التأمل (103)",
"type": "courses"
}
],
"status_code": 200
}
Authorization
All favorite endpoints require admin authorization. The user must have the appropriate permissions to perform these operations.