Publications

This guide explains how to interact with the Publications API in the Sumaya369 application.

List Publications

Endpoint

• Method: GET
• URL: /v1/customer/publications

Request Headers

Header	Value	Required
Content-Type	application/json	Yes
Accept	application/json	Yes

Query Parameters

Parameter	Type	Description	Required
per_page	integer	Number of publications per page (default: 10)	No
type	string	Filter publications by type (books, albums and cards are currently available)	No

Success Response

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": {
        "current_page": 1,
        "first_page_url": "http://testing-api.sumaya369.net/v1/customer/publications?type=books&page=1",
        "from": 1,
        "last_page": 1,
        "last_page_url": "http://testing-api.sumaya369.net/v1/customer/publications?type=books&page=1",
        "links": [
            {
                "url": null,
                "label": "« السابق",
                "active": false
            },
            {
                "url": "http://testing-api.sumaya369.net/v1/customer/publications?type=books&page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "التالي »",
                "active": false
            }
        ],
        "next_page_url": null,
        "path": "http://testing-api.sumaya369.net/v1/customer/publications",
        "per_page": 10,
        "prev_page_url": null,
        "to": 5,
        "total": 5,
        "seo": {
            "keywords": "الدكتورة سمية الناصر,موقع الدكتورة سمية الناصر,دورات سمية الناصر,مقالات سمية الناصر,سمية الناصر الموقع الرسمي,كتب تتحدث عن الجسد المشاعري,sumaya369,الجسد المشاعري,خريطة المشاعر",
            "author": "الدكتورة سمية الناصر",
            "description": "الموقع الرسمي لدكتورة سمية الناصر| مواد - مقالات - كتب - اصدارات.",
            "title": "الرئيسية"
        },
        "publications": [
            {
                "id": "00d33520-4f94-11ed-a6b9-b5839356bff7",
                "name": "لا تقلق",
                "slug": "لا-تقلق",
                "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/5072/%D8%BA%D9%84%D8%A7%D9%81-%D8%A7%D9%85%D8%A7%D9%85%D9%8A--%281%29.jpg",
                "type": "books",
                "model_type": "publications",
                "translate_type": "كتاب",
                "favorite": null
            },
            {
                "id": "1b0b98fa-f78e-46cc-b87b-945834a48609",
                "name": "أفعلها / أبقى إيجابياً",
                "slug": "أفعلها-أبقى-إيجابيا",
                "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/613/%D8%BA%D9%84%D8%A7%D9%81-%D9%83%D8%AA%D8%A7%D8%A8-%D8%A7%D9%81%D8%B9%D9%84%D9%87%D8%A7-%D9%85%D9%88%D9%82%D8%B9.png",
                "type": "books",
                "model_type": "publications",
                "translate_type": "كتاب",
                "favorite": null
            },
            {
                "id": "5ace8d14-8cc3-4a9e-ac42-28d71ac6ab31",
                "name": "حدثني فقال2",
                "slug": "حدثني-فقال2",
                "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/609/%D8%BA%D9%84%D8%A7%D9%81-%D9%83%D8%AA%D8%A7%D8%A8-%D8%AD%D8%AF%D8%AB%D9%86%D9%8A-2-%D9%85%D9%88%D9%82%D8%B9.png",
                "type": "books",
                "model_type": "publications",
                "translate_type": "كتاب",
                "favorite": null
            },
            {
                "id": "2f36905d-d1ec-44b1-9b6d-c337041daea4",
                "name": "كيف تتقن لعبة الحياة",
                "slug": "كيف-تتقن-لعبة-الحياة",
                "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/607/%D8%BA%D9%84%D8%A7%D9%81-%D9%83%D8%AA%D8%A7%D8%A8-%D9%83%D9%8A%D9%81-%D8%AA%D8%AA%D9%82%D9%86-%D9%84%D8%B9%D8%A8%D8%A9-%D8%A7%D9%84%D8%AD%D9%8A%D8%A7%D8%A9-%D9%85%D9%88%D9%82%D8%B9.png",
                "type": "books",
                "model_type": "publications",
                "translate_type": "كتاب",
                "favorite": null
            },
            {
                "id": "0cb16771-1a85-4c43-b6c3-b8b0893fd1be",
                "name": "حدثني فقال",
                "slug": "حدثني-فقال",
                "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/603/%D8%BA%D9%84%D8%A7%D9%81-%D9%83%D8%AA%D8%A7%D8%A8-%D8%AD%D8%AF%D8%AB%D9%86%D9%8A-%D9%81%D9%82%D8%A7%D9%841-%D9%85%D9%88%D9%82%D8%B9.png",
                "type": "books",
                "model_type": "publications",
                "translate_type": "كتاب",
                "favorite": null
            }
        ]
    },
    "status_code": 200
}

Get Single Publication

Endpoint

• Method: GET
• URL: /v1/customer/publications/{id_or_slug}

Request Headers

Header	Value	Required
Content-Type	application/json	Yes
Accept	application/json	Yes

Path Parameters

Parameter	Type	Description	Required
id_or_slug	string	Publication UUID or slug	Yes

Query Parameters

Parameter	Type	Description	Required
type	string	Specify publication type (books, albums and cards are currently available)	No
view	boolean	Include inactive publications (for admin)	No

Success Response

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": {
        "id": "5ace8d14-8cc3-4a9e-ac42-28d71ac6ab31",
        "name": "حدثني فقال2",
        "description": "<p>تقول الدكتورة سمية: الحياة أقصر من أن تتعلمها بنفسك لذا اتخذ لك معلماً.</p><p>في هذا الكتاب تعلمنا الدكتورة أثمن دروس الحياة، والتي تختصر بها طريقك بذكاء وحب، تجد هنا دروساً تتحدث مرة</p><p>عن المشاعر ومرة عن الأفكار وتارة عن ذاتك وتارة عن المحيطين بك، ستشعر بتجدد وتطور، وأنت تقرأ بعمق هذه</p><p>العبارات النيرة.</p><p>&nbsp;تقترح عليك الدكتورة سمية: أن تفتح كل يوم صفحة من الكتاب على نحو عشوائي، وتعتبرها رسالتك لليوم..</p><p><br></p><p><br></p><p>\r\n</p><p><strong>أين يمكنك إيجاد الكتاب ؟\r\n</strong></p><p><br></p><p><br></p><p><strong>أمـاكن التوافر أون لاين :</strong></p><p> جملون | موكابوك | دار ملهمون | النيل والفرات | جرير</p><p><br></p><p>\r\n</p><p><img src=\"https://sumaya369-production-media.s3.us-east-2.amazonaws.com/front-end/images/2x71yfXo3epVlEcZn3KOzllyk74eqgpzOYp0PRBk.png\" width=\"537\" style=\"cursor: nwse-resize;\"></p>",
        "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/609/%D8%BA%D9%84%D8%A7%D9%81-%D9%83%D8%AA%D8%A7%D8%A8-%D8%AD%D8%AF%D8%AB%D9%86%D9%8A-2-%D9%85%D9%88%D9%82%D8%B9.png",
        "type": "books",
        "can_comment": true,
        "model_type": "publications",
        "translate_type": "كتاب",
        "tag_names": [],
        "comments_count": 1,
        "favorite": null,
        "publications_favorites": [],
        "watch_also": [
            {
                "id": "00d33520-4f94-11ed-a6b9-b5839356bff7",
                "name": "لا تقلق",
                "slug": "لا-تقلق",
                "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/5072/%D8%BA%D9%84%D8%A7%D9%81-%D8%A7%D9%85%D8%A7%D9%85%D9%8A--%281%29.jpg",
                "type": "books",
                "model_type": "publications",
                "translate_type": "كتاب",
                "favorite": null
            },
            {
                "id": "1b0b98fa-f78e-46cc-b87b-945834a48609",
                "name": "أفعلها / أبقى إيجابياً",
                "slug": "أفعلها-أبقى-إيجابيا",
                "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/613/%D8%BA%D9%84%D8%A7%D9%81-%D9%83%D8%AA%D8%A7%D8%A8-%D8%A7%D9%81%D8%B9%D9%84%D9%87%D8%A7-%D9%85%D9%88%D9%82%D8%B9.png",
                "type": "books",
                "model_type": "publications",
                "translate_type": "كتاب",
                "favorite": null
            },
            {
                "id": "2f36905d-d1ec-44b1-9b6d-c337041daea4",
                "name": "كيف تتقن لعبة الحياة",
                "slug": "كيف-تتقن-لعبة-الحياة",
                "poster": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/607/%D8%BA%D9%84%D8%A7%D9%81-%D9%83%D8%AA%D8%A7%D8%A8-%D9%83%D9%8A%D9%81-%D8%AA%D8%AA%D9%82%D9%86-%D9%84%D8%B9%D8%A8%D8%A9-%D8%A7%D9%84%D8%AD%D9%8A%D8%A7%D8%A9-%D9%85%D9%88%D9%82%D8%B9.png",
                "type": "books",
                "model_type": "publications",
                "translate_type": "كتاب",
                "favorite": null
            }
        ],
        "seo": {
            "title": "إصدار حدثني فقال2",
            "description": "تقول الدكتورة سمية الحياة أقصر من أن تتعلمها بنفسك لذا ...",
            "image": "https://sumaya369-testing-media.s3.us-east-2.amazonaws.com/609/%D8%BA%D9%84%D8%A7%D9%81-%D9%83%D8%AA%D8%A7%D8%A8-%D8%AD%D8%AF%D8%AB%D9%86%D9%8A-2-%D9%85%D9%88%D9%82%D8%B9.png",
            "type": "publications",
            "locale": "ar_SA",
            "site_name": "Sumaya369",
            "keywords": "الدكتورة سمية الناصر,موقع الدكتورة سمية الناصر,دورات سمية الناصر,مقالات سمية الناصر,سمية الناصر الموقع الرسمي,كتب تتحدث عن الجسد المشاعري,sumaya369,الجسد المشاعري,خريطة المشاعر",
            "author": "الدكتورة سمية الناصر",
            "published_time": "2020-06-08T13:45:32+03:00",
            "modified_time": "2024-05-21T17:10:06+03:00",
            "article_tags": "",
            "article_section": "إصدار"
        }
    },
    "status_code": 200
}

Error Responses

Publication Not Found (404)

{
    "success": false,
    "message": "لم يتم العثور على السجل",
    "data": [],
    "status_code": 404
}

Example Implementation Flow

1. Publication Listing

   • Application sends request to /v1/customer/publications
   • Optional query parameters:
     • Filter by publication type
     • Specify number of publications per page
   • Display publications with pagination
   • Show SEO metadata

2. Single Publication View

   • User selects a publication
   • Application sends request to /v1/customer/publications/{id_or_slug}
   • Display publication details
   • Show related publications and favorites