Publication
This section covers the API endpoints for managing publications in the admin panel.
List Publications
GET /v1/admin/publications
Returns a paginated list of all publications.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
search_text | string | Search publications by name |
filter[type] | string | Filter by publication type (books, albums and cards are currently available) |
filter[active] | boolean | Filter by active status |
filter[can_comment] | boolean | Filter by comment permission |
filter[trashed] | boolean | Include trashed publications |
sort | string | Sort by field (prefix with - for descending) |
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/publications?filter%5Btype%5D=books&page=1",
"from": 1,
"last_page": 1,
"last_page_url": "http://192.168.0.139:8080/v1/admin/publications?filter%5Btype%5D=books&page=1",
"links": [
{
"url": null,
"label": "« السابق",
"active": false
},
{
"url": "http://192.168.0.139:8080/v1/admin/publications?filter%5Btype%5D=books&page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "التالي »",
"active": false
}
],
"next_page_url": null,
"path": "http://192.168.0.139:8080/v1/admin/publications",
"per_page": 10,
"prev_page_url": null,
"to": 5,
"total": 5,
"publications": [
{
"id": "00d33520-4f94-11ed-a6b9-b5839356bff7",
"name": "لا تقلق",
"poster": "http://192.168.0.139:8080/storage/5072/غلاف-امامي--(1).jpg",
"active": true,
"can_comment": true,
"views_count": 0,
"comments_count": 7,
"type": "books",
"user_id": "158e72ff-9a1d-42f9-8345-99300fee6313"
},
{
"id": "1b0b98fa-f78e-46cc-b87b-945834a48609",
"name": "أفعلها / أبقى إيجابياً",
"poster": "http://192.168.0.139:8080/storage/613/غلاف-كتاب-افعلها-موقع.png",
"active": true,
"can_comment": true,
"views_count": 0,
"comments_count": 8,
"type": "books",
"user_id": null
},
{
"id": "5ace8d14-8cc3-4a9e-ac42-28d71ac6ab31",
"name": "حدثني فقال2",
"poster": "http://192.168.0.139:8080/storage/609/غلاف-كتاب-حدثني-2-موقع.png",
"active": true,
"can_comment": true,
"views_count": 0,
"comments_count": 2,
"type": "books",
"user_id": null
},
{
"id": "2f36905d-d1ec-44b1-9b6d-c337041daea4",
"name": "كيف تتقن لعبة الحياة",
"poster": "http://192.168.0.139:8080/storage/607/غلاف-كتاب-كيف-تتقن-لعبة-الحياة-موقع.png",
"active": true,
"can_comment": true,
"views_count": 0,
"comments_count": 3,
"type": "books",
"user_id": null
},
{
"id": "0cb16771-1a85-4c43-b6c3-b8b0893fd1be",
"name": "حدثني فقال",
"poster": "http://192.168.0.139:8080/storage/603/غلاف-كتاب-حدثني-فقال1-موقع.png",
"active": true,
"can_comment": true,
"views_count": 0,
"comments_count": 1,
"type": "books",
"user_id": null
}
]
},
"status_code": 200
}
Get Publication Statistics
GET /v1/admin/publications/statistics
Returns statistics about publications including total views and most viewed/commented publications.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
type | string | Required. Publication type to get statistics for (books, albums and cards are currently available) |
Response
{
"success": true,
"message": "تم جلب البيانات بنجاح.",
"data": {
"total_views": "25k",
"most_viewed": {
"poster": "http://192.168.0.139:8080/storage/884/c126741b--توافر-افعلها-بطاقات-889x1024-(4).png",
"name": "ابق ايجابياً",
"views": "11.33k"
},
"most_commented": {
"poster": "http://192.168.0.139:8080/storage/884/c126741b--توافر-افعلها-بطاقات-889x1024-(4).png",
"name": "افعلها",
"comments_count": "13"
},
"most_viewed_cards": [
{
"name": "افعلها",
"views": "15.87k"
},
{
"name": "ابق ايجابياً",
"views": "15.89k"
}
]
},
"status_code": 200
}
Create Publication
POST /v1/admin/publications/{type}
Create a new publication.
Request Body
| Parameter | Type | Description |
|---|---|---|
name | string | Required. Publication name (3-255 characters) |
description | string | Required. Publication description (min: 3 characters) |
poster | file | Required. Image file (jpeg, png, jpg, max: 1MB) |
active | boolean | Required. Publication active status |
can_comment | boolean | Required. Allow comments on publication |
tag_names | array | Optional. Array of tag names |
Response
{
"success": true,
"message": "تم حفظ البيانات بنجاح.",
"data": {
"id": "da8279d0-0858-11f0-a9ff-495401c73958",
"name": "يسيراً: إذ كان مكتسياً بالجلود، وقد كان تبين له أثناء.؟",
"description": "يحتاج إلى بيان أكثر من استعداد الجسم",
"brief_description": "يحتاج إلى بيان أكثر من استعداد الجسم...",
"poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/23671/Screenshot-from-2025-02-24-13-39-01.png",
"active": false,
"can_comment": false,
"comments_count": 0,
"views_count": 0,
"type": "cards",
"user_id": "3a0a4810-dab4-11ec-8e1b-cb15cec27c77",
"tag_names": [
"بلابلا"
],
"tags": [
{
"id": "daa14110-0858-11f0-b790-17bd11d2bf15",
"name": "بلابلا",
"color": "#98DEDE",
"pivot": {
"taggable_type": "App\\Models\\Publication",
"taggable_id": "da8279d0-0858-11f0-a9ff-495401c73958",
"tag_id": "daa14110-0858-11f0-b790-17bd11d2bf15"
},
"created_at": "2025-03-24 05:36:56",
"updated_at": "2025-03-24 05:36:56"
}
]
},
"status_code": 200
}
Get Publication
GET /v1/admin/publications/{id}
Retrieve details of a specific publication.
Response
{
"success": true,
"message": "تم جلب البيانات بنجاح.",
"data": {
"id": "00d33520-4f94-11ed-a6b9-b5839356bff7",
"name": "لا تقلق",
"description": "<p>هل تشعر بأن الحياة صعبة؟</p><p>هل تشعر أن كل شيء يحتاج جهداً كبير حتى يتحقق؟</p><p>لا تقلق.</p><p>لقد خُلقتَ بشكلٍ كاملٍ شاملٍ للأدوات اللَّازمة لأداءِ رسالتِكَ في هذِهِ التجرِبَةِ الأرضيَّة.</p><p>أنت تملك أدواتٍ خاصَّةً فيك، تستخدمها فــي وقتها لتأدِيَة مسؤوليَّتِكَ.</p><p>حين لا تستطيع عملًا معيّنًا، أو حين يكون العمل صعبًا جدًّا عليك، أو حين يكون العمل</p><p>يحتاج إلى إعدادٍ مرهِقٍ ومُجْهِدٍ؛ فهذا ليسَ دورَكَ.</p><p>لا ترهِقْ نفسكَ في دورٍ ليس لك، وطريق ليس طريقَكَ.</p><p>أنت جاهزٌ لطريقك فقط!</p><p>في كتاب لا تقلق هناك 90 سراً يجعلك مطمئناً مهما حدث في حياتك.</p><p><br></p><p><br></p><p><strong>أين يمكنك ايجاد الكتاب ؟</strong></p><p><br></p><p><strong>أمـاكن التوافر أون لاين :</strong></p><p>موكابوك | دار ملهمون | جرير</p><p><br></p><p><img src=\"https://sumaya369-production-media.s3.us-east-2.amazonaws.com/front-end/images/lsuqFKM7JnhyHgcHUjG4Y69B1spfBr8UmigkSqjV.png\"></p><p class=\"ql-align-right\"><br></p>",
"brief_description": "هل تشعر بأن الحياة صعبةهل تشعر أن كل شيء يحتاج جهدا كبي?...",
"poster": "http://192.168.0.139:8080/storage/5072/غلاف-امامي--(1).jpg",
"active": true,
"can_comment": true,
"comments_count": 7,
"views_count": 0,
"type": "books",
"user_id": "158e72ff-9a1d-42f9-8345-99300fee6313",
"tag_names": [],
"tags": []
},
"status_code": 200
}
Update Publication
PATCH /v1/admin/publications/{id}
Update an existing publication.
Request Body
| Parameter | Type | Description |
|---|---|---|
name | string | Optional. Publication name (3-255 characters) |
description | string | Optional. Publication description (min: 3 characters) |
poster | file | Optional. Image file (jpeg, png, jpg, max: 1MB) |
active | boolean | Optional. Publication active status |
can_comment | boolean | Optional. Allow comments on publication |
tag_names | array | Optional. Array of tag names |
Response
{
"success": true,
"message": "تم تحديث البيانات بنجاح.",
"data": {
"id": "00d33520-4f94-11ed-a6b9-b5839356bff7",
"name": "لا تقلق",
"description": "<p>هل تشعر بأن الحياة صعبة؟</p><p>هل تشعر أن كل شيء يحتاج جهداً كبير حتى يتحقق؟</p><p>لا تقلق.</p><p>لقد خُلقتَ بشكلٍ كاملٍ شاملٍ للأدوات اللَّازمة لأداءِ رسالتِكَ في هذِهِ التجرِبَةِ الأرضيَّة.</p><p>أنت تملك أدواتٍ خاصَّةً فيك، تستخدمها فــي وقتها لتأدِيَة مسؤوليَّتِكَ.</p><p>حين لا تستطيع عملًا معيّنًا، أو حين يكون العمل صعبًا جدًّا عليك، أو حين يكون العمل</p><p>يحتاج إلى إعدادٍ مرهِقٍ ومُجْهِدٍ؛ فهذا ليسَ دورَكَ.</p><p>لا ترهِقْ نفسكَ في دورٍ ليس لك، وطريق ليس طريقَكَ.</p><p>أنت جاهزٌ لطريقك فقط!</p><p>في كتاب لا تقلق هناك 90 سراً يجعلك مطمئناً مهما حدث في حياتك.</p><p><br></p><p><br></p><p><strong>أين يمكنك ايجاد الكتاب ؟</strong></p><p><br></p><p><strong>أمـاكن التوافر أون لاين :</strong></p><p>موكابوك | دار ملهمون | جرير</p><p><br></p><p><img src=\"https://sumaya369-production-media.s3.us-east-2.amazonaws.com/front-end/images/lsuqFKM7JnhyHgcHUjG4Y69B1spfBr8UmigkSqjV.png\"></p><p class=\"ql-align-right\"><br></p>",
"brief_description": "هل تشعر بأن الحياة صعبةهل تشعر أن كل شيء يحتاج جهدا كبي?...",
"poster": "http://192.168.0.139:8080/storage/5072/غلاف-امامي--(1).jpg",
"active": true,
"can_comment": false,
"comments_count": 7,
"views_count": 0,
"type": "books",
"user_id": "158e72ff-9a1d-42f9-8345-99300fee6313",
"tag_names": [],
"tags": []
},
"status_code": 200
}
Delete Publications
DELETE /v1/admin/publications
Delete one or more publications.
Request Body
| Parameter | Type | Description |
|---|---|---|
ids | array | Required. Array of publication UUIDs to delete |
Response
{
"success": true,
"message": "تم حذف البيانات بنجاح.",
"data": null,
"status_code": 200
}
Authorization
All publication endpoints require admin authorization. The user must have the appropriate permissions to perform these operations.