Articles

This guide explains how to interact with the Articles API in the Sumaya369 mobile application. The API provides endpoints for retrieving, managing, and interacting with various articles, including features like pagination, category filtering, and detailed article views.

List Articles

Retrieve a paginated list of articles with optional category filtering. This endpoint returns a comprehensive list of articles with essential metadata, and view counts.

Endpoint

• Method: GET
• URL: /v1/mobile/articles

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 articles per page (default: 10)	No
category	string	Filter articles by category name	No

Success Response

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": {
        "current_page": 1,
        "first_page_url": "http://127.0.0.1:8000/v1/mobile/articles?page=1",
        "from": 1,
        "last_page": 23,
        "last_page_url": "http://127.0.0.1:8000/v1/mobile/articles?page=23",
        "links": [
            {
                "url": null,
                "label": "« السابق",
                "active": false
            },
            {
                "url": "http://127.0.0.1:8000/v1/mobile/articles?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": "http://127.0.0.1:8000/v1/mobile/articles?page=2",
                "label": "2",
                "active": false
            },
            {
                "url": "http://127.0.0.1:8000/v1/mobile/articles?page=3",
                "label": "3",
                "active": false
            },
            {
                "url": "http://127.0.0.1:8000/v1/mobile/articles?page=4",
                "label": "4",
                "active": false
            },
            {
                "url": "http://127.0.0.1:8000/v1/mobile/articles?page=5",
                "label": "5",
                "active": false
            },
            {
                "url": "http://127.0.0.1:8000/v1/mobile/articles?page=6",
                "label": "6",
                "active": false
            },
            {
                "url": "http://127.0.0.1:8000/v1/mobile/articles?page=7",
                "label": "7",
                "active": false
            },
            {
                "url": "http://127.0.0.1:8000/v1/mobile/articles?page=8",
                "label": "8",
                "active": false
            },
            {
                "url": "http://127.0.0.1:8000/v1/mobile/articles?page=9",
                "label": "9",
                "active": false
            },
            {
                "url": "http://127.0.0.1:8000/v1/mobile/articles?page=10",
                "label": "10",
                "active": false
            },
            {
                "url": null,
                "label": "...",
                "active": false
            },
            {
                "url": "http://127.0.0.1:8000/v1/mobile/articles?page=22",
                "label": "22",
                "active": false
            },
            {
                "url": "http://127.0.0.1:8000/v1/mobile/articles?page=23",
                "label": "23",
                "active": false
            },
            {
                "url": "http://127.0.0.1:8000/v1/mobile/articles?page=2",
                "label": "التالي »",
                "active": false
            }
        ],
        "next_page_url": "http://127.0.0.1:8000/v1/mobile/articles?page=2",
        "path": "http://127.0.0.1:8000/v1/mobile/articles",
        "per_page": 10,
        "prev_page_url": null,
        "to": 10,
        "total": 224,
        "articles": [
            {
                "id": "377d34a0-3f25-11ee-8738-c909ac5b1bc4",
                "title": "اللعبة 🎮",
                "brief_description": "يختار بعض الناس عدم اللعب  ولأن أجسادهم الفكرية متضخمة ...",
                "poster": "http://127.0.0.1:8000/storage/16355/صورة2.png",
                "can_comment": true,
                "comments_count": 121,
                "views": 13167,
                "model_type": "articles",
                "favorite": null
            },
            {
                "id": "2a86bfe0-3f24-11ee-8cc9-eb1b27f95d9c",
                "title": "ماهو توقيت متعتك؟",
                "brief_description": " لدى غالبية الناس توقيت معين للمتعة  وذلك ضمن برامجهم ا?...",
                "poster": "http://127.0.0.1:8000/storage/16354/pleasure-time.png",
                "can_comment": true,
                "comments_count": 111,
                "views": 10620,
                "model_type": "articles",
                "favorite": null
            },
            {
                "id": "f083c6c0-3c08-11ee-a0f5-3325cca2539b",
                "title": "مستمتع؟",
                "brief_description": "  لدى غالبية الناس تصور محدود لمعنى المتعة وشكل المتعة ?...",
                "poster": "http://127.0.0.1:8000/storage/16263/joyfull.png",
                "can_comment": true,
                "comments_count": 42,
                "views": 4051,
                "model_type": "articles",
                "favorite": null
            },
            {
                "id": "716852d0-2b84-11ee-b5cf-e38674657e7c",
                "title": "خلافات زوجية",
                "brief_description": " حين يكون الشخص نائم ستكون خلافاته مع شريك الحياة على ش?...",
                "poster": "http://127.0.0.1:8000/storage/15509/صورة14.png",
                "can_comment": true,
                "comments_count": 13,
                "views": 1855,
                "model_type": "articles",
                "favorite": null
            },
            {
                "id": "e4e0ff10-2949-11ee-b9c5-a536ce9acd8d",
                "title": "من الفائز ؟؟",
                "brief_description": "كنت احتاج الى صورة لإظهار فكرة الخلافات والمشادات في ا?...",
                "poster": "http://127.0.0.1:8000/storage/15425/صورة12.jpg",
                "can_comment": true,
                "comments_count": 8,
                "views": 961,
                "model_type": "articles",
                "favorite": null
            },
            {
                "id": "bf105270-260a-11ee-849d-ebb00bcf2a9d",
                "title": "لعبة البس والفار",
                "brief_description": " تركض خلفه ليتقدم لها  وتتلاعب بأفكاره ومشاعره حتى يقرر...",
                "poster": "http://127.0.0.1:8000/storage/15296/ت.png",
                "can_comment": true,
                "comments_count": 11,
                "views": 933,
                "model_type": "articles",
                "favorite": null
            },
            {
                "id": "c9baa680-23b6-11ee-9bdb-1bb6bba118b8",
                "title": "هل أقبل به؟",
                "brief_description": "وهل هو رجل جيدوهل هذا الرجل هو من أبحث عنهقد تبحثين عن ج...",
                "poster": "http://127.0.0.1:8000/storage/15196/الالا.png",
                "can_comment": true,
                "comments_count": 9,
                "views": 1269,
                "model_type": "articles",
                "favorite": null
            },
            {
                "id": "007f2d10-1efa-11ee-9bb6-a5d9f97a4985",
                "title": "محتار ؟",
                "brief_description": "الطبيعي أن يكون لديك أجساد متطابقة  فما تشعر به هو ما تف...",
                "poster": "http://127.0.0.1:8000/storage/14924/jj.png",
                "can_comment": true,
                "comments_count": 7,
                "views": 924,
                "model_type": "articles",
                "favorite": null
            },
            {
                "id": "ad386330-1bd5-11ee-9dde-f1f32a68017b",
                "title": "خزاناتك المشاعرية",
                "brief_description": "خلف هذا الجسد المشاعري الجبار  خزانات تجعل هذا الجسد صا...",
                "poster": "http://127.0.0.1:8000/storage/14939/خزانات.png",
                "can_comment": true,
                "comments_count": 13,
                "views": 1584,
                "model_type": "articles",
                "favorite": null
            },
            {
                "id": "8300d1d0-1bd5-11ee-9156-0d54d4d13469",
                "title": "قصة الشعور",
                "brief_description": "شعورك له قصة وتاريخ وأنت غالبا لا تعرف تاريخ شعورك لأنه...",
                "poster": "http://127.0.0.1:8000/storage/14922/hn2.png",
                "can_comment": true,
                "comments_count": 3,
                "views": 883,
                "model_type": "articles",
                "favorite": null
            }
        ]
    },
    "status_code": 200
}

Get Single Article

Retrieve detailed information about a specific article by its ID or slug. This endpoint returns the full article content, media assets, view counts, and related articles. It also includes favorite status for authenticated users.

Endpoint

• Method: GET
• URL: /v1/mobile/articles/{id_or_slug}

Path Parameters

Parameter	Type	Description	Required
id_or_slug	string	Article UUID or slug	Yes

Query Parameters

Parameter	Type	Description	Required
view	boolean	Include trashed articles (for admin)	No

Success Response

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": {
        "id": "377d34a0-3f25-11ee-8738-c909ac5b1bc4",
        "title": "اللعبة 🎮",
        "slug": "اللعبة",
        "body": "<p><span style=\"color: black;\">يختار بعض الناس عدم اللعب ، ولأن أجسادهم الفكرية متضخمة يعتقدون بأن اللعب سلوك ذو قيمة منخفضة </span></p><p><span style=\"color: black;\"> </span></p><p><span style=\"color: black;\"> ويختار البعض اللعب في لعبة تثير الغضب والقلق والتوتر، وحين يبدأ اللعبة كأنه يضغط الزناد على أسوأ مشاعره السلبية ، ويعيش لساعات طويلة تحت هذا الضغط ؛ ويقول بأنه مستمتع بهذه اللعبة </span></p><p><span style=\"color: black;\"> </span></p><p><span style=\"color: black;\"> ويختار بعض الناس اللعب لأن هذا يساعدهم في تنشيط ابداعهم ، وفي الاتصال مع ذواتهم… بل انهم يتذكرون من هم بوعي أو بلاوعي من خلال هذه اللعبة</span></p><p><span style=\"color: black;\"> </span></p><p><span style=\"color: black;\"> ويختار البعض اللعب بعد يوم طويل ومرهق حتى يشعر بالهدوء والاسترخاء والسلام والاستمتاع </span></p><p><span style=\"color: black;\"> فهو يستخدم اللعبة طوال الوقت كأداة لتطوير جسده المشاعري </span></p><p><span style=\"color: black;\"> </span></p><p><span style=\"color: black;\"> من الغريب جداً أن تعرف بأن بعض الأشخاص يحصلون على شعور جيد في اللعبة لا يحصلون عليه في الحياة الواقعية ؛ وهذا يعني بأنهم يعيشون حياة حقيقية أكثر هناك (في اللعبة) .</span></p><p><br></p><p><br></p><p><span style=\"color: black;\"> </span></p><p><strong style=\"color: black;\"> والسؤال الآن:</strong></p><p><strong style=\"color: black;\"> ماهي لعبتك المفضلة؟ وما هو شعورها؟</strong></p><p class=\"ql-align-right\"><strong style=\"color: black;\"> شاركنا بحب.. </strong></p>",
        "brief_description": "يختار بعض الناس عدم اللعب  ولأن أجسادهم الفكرية متضخمة ...",
        "poster": "http://127.0.0.1:8000/storage/16355/صورة2.png",
        "can_comment": true,
        "tag_names": [],
        "favorite": null,
        "comments_count": 121,
        "views": 13169,
        "model_type": "articles",
        "articles_favorites": []
    },
    "status_code": 200
}

Error Responses

Article Not Found (404)

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

Example Implementation Flow

1. Article Listing

   • Application sends request to /v1/mobile/articles
   • Optional query parameters:
     • Filter by category
     • Specify number of articles per page
   • Display articles with pagination

2. Single Article View

   • User selects an article
   • Application sends request to /v1/mobile/articles/{id_or_slug}
   • Display full article content
   • Show related articles and favorites
   • Record article view count

Key Considerations

• Server-side caching is used when the user is not authenticated.
• eloquent-viewable package is used to handle article views.