عرض المنشورات

استرجع قائمة مقسّمة على صفحات من منشوراتك الاجتماعية.

الطلب

اجلب سجل منشوراتك مع الصفحات وتصفية الحالة وتصفية المنصة.

الصلاحية المطلوبة: posts:read

معاملات الاستعلام

limitintegerOptional

Default: 50

أقصى عدد منشورات تُعاد لكل صفحة. المدى: 1–100.

offsetintegerOptional

Default: 0

عدد المنشورات المراد تخطّيها. يُستخدم للصفحات.

statusstringOptional

تصفية بحالة المنشور. القيم: DRAFT، SCHEDULED، PROCESSING، PUBLISHED، FAILED، PARTIALLY_PUBLISHED. غير حسّاس لحالة الأحرف.

platformstringOptional

تصفية بالمنصة المستهدفة. القيم: TWITTER، INSTAGRAM، LINKEDIN، FACEBOOK، TIKTOK، YOUTUBE، PINTEREST، SNAPCHAT. يعيد فقط المنشورات المرتبطة بحسابات على هذه المنصة.

مثال طلب

curl "https://app.ewasl.com/api/v1/posts?limit=10&status=published" \
  -H "Authorization: Bearer ewasl_YOUR_API_KEY"

الاستجابة

يعيد قائمة مقسّمة على صفحات من كائنات المنشورات.

dataarray

قائمة كائنات المنشورات.

metaobject

بيانات الصفحات.

Response Example

{
  "data": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "content": "Check out our new feature!",
      "status": "PUBLISHED",
      "platforms": ["twitter", "linkedin"],
      "mediaUrls": [],
      "scheduledAt": null,
      "publishedAt": "2026-02-14T10:05:00Z",
      "createdAt": "2026-02-14T10:00:00Z",
      "updatedAt": "2026-02-14T10:05:00Z"
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "content": "Draft post for next week",
      "status": "DRAFT",
      "platforms": ["instagram"],
      "mediaUrls": ["https://example.com/photo.jpg"],
      "scheduledAt": null,
      "publishedAt": null,
      "createdAt": "2026-02-13T15:30:00Z",
      "updatedAt": "2026-02-13T15:30:00Z"
    }
  ],
  "meta": {
    "total": 245,
    "offset": 0,
    "limit": 10,
    "next": "/api/v1/posts?offset=10&limit=10"
  }
}