المنشورات

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

يسرد منشورات المنشآت التي يصل إليها الرمز، الأحدث أولًا، مع تصفية حسب المنشأة والحالة والفترة والكاتب، صفحة بصفحة.

GEThttps://api.sofia-post.com/api/v1/posts

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

التفويضات

Authorizationstringمطلوب

مفتاحك الشخصي أو رمز وصول OAuth، يُرسل كـ Bearer <token>.

يبقى في هذا التبويب فقط، ويُرسل إلى api.sofia-post.com فقط. احصل على مفتاح API

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

establishmentIdstring

منشورات هذه المنشأة فقط.

cursorstring

قيمة nextCursor من الصفحة السابقة.

statusstring

في الوضع الفعلي: شبكة واحدة على الأقل في هذه الحالة. تلخّص status حالات شبكات المنشور، لذا قد تعيد التصفية على failed منشورًا partial.

fromstring<date-time>

في الوضع الفعلي: شبكة واحدة على الأقل نُشر عليها (أو جُدول النشر عليها قبل النشر) ابتداءً من هذه اللحظة.

tostring<date-time>

في الوضع الفعلي: وقبل هذه اللحظة (مستبعدة).

createdBystring

في الوضع الفعلي: me لمنشورات الشخص الذي يتصرف الرمز نيابةً عنه، وapp لما أنشأه هذا التطبيق. عند الغياب: الكل.

limitnumber

حجم الصفحة، من 1 إلى 100 (الافتراضي 20).

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

curl -X GET 'https://api.sofia-post.com/api/v1/posts' \
  -H "Authorization: Bearer $SOFIA_API_KEY"

{
  "data": [
    {
      "id": "string",
      "status": "published",
      "establishmentId": "string",
      "scheduledAt": "2026-11-02T10:00:00.000Z",
      "createdAt": "2026-11-02T10:00:00.000Z",
      "targets": [
        {
          "platform": "instagram",
          "accountId": "string",
          "state": "published",
          "permalink": "https://www.instagram.com/p/C1"
        }
      ]
    }
  ]
}

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

curl --request GET \
  --url 'https://api.sofia-post.com/api/v1/posts' \
  --header "Authorization: Bearer $SOFIA_API_KEY"

{
  "data": [
    {
      "id": "string",
      "status": "published",
      "establishmentId": "string",
      "scheduledAt": "2026-11-02T10:00:00.000Z",
      "createdAt": "2026-11-02T10:00:00.000Z",
      "targets": [
        {
          "platform": "instagram",
          "accountId": "string",
          "state": "published",
          "permalink": "https://www.instagram.com/p/C1"
        }
      ]
    }
  ]
}

GET /v1/posts يسرد كل المنشورات المتاحة للرمز، الأحدث أولًا، مرشّحة بـ establishmentId وstatus وfrom وto وcreatedBy (me أو app). يطابق المنشور status حين تكون إحدى شبكاته على الأقل في هذه الحالة. انظر الترقيم.

حالات المنشور الممكنة موصوفة في صفحة قراءة منشور.

التفويضات

Authorizationstringheaderمطلوب
مفتاحك الشخصي أو رمز وصول OAuth، يُرسل كـ Bearer <token>.

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

establishmentIdstring
منشورات هذه المنشأة فقط.
cursorstring
قيمة nextCursor من الصفحة السابقة.
statusstring
في الوضع الفعلي: شبكة واحدة على الأقل في هذه الحالة. تلخّص status حالات شبكات المنشور، لذا قد تعيد التصفية على failed منشورًا partial.
القيم المسموحة: draftscheduledpublishingpublishedsent_to_inboxfailed
fromstring<date-time>
في الوضع الفعلي: شبكة واحدة على الأقل نُشر عليها (أو جُدول النشر عليها قبل النشر) ابتداءً من هذه اللحظة.
tostring<date-time>
في الوضع الفعلي: وقبل هذه اللحظة (مستبعدة).
createdBystring
في الوضع الفعلي: me لمنشورات الشخص الذي يتصرف الرمز نيابةً عنه، وapp لما أنشأه هذا التطبيق. عند الغياب: الكل.
القيم المسموحة: meapp
limitnumber
حجم الصفحة، من 1 إلى 100 (الافتراضي 20).

الاستجابة

صفحة منشورات، مع nextCursor عند وجود المزيد.

dataobject[]مطلوب
منشورات الصفحة
عرض الخصائص الفرعية
- idstringمطلوب
  معرّف المنشور
- statusstringمطلوب
  عبر كل الشبكات؛ partial: نُشر على واحدة وفشل على أخرى
  القيم المسموحة: draftscheduledpublishingpublishedsent_to_inboxfailedpartial
- establishmentIdstringمطلوب
  منشأة المنشور
- createdAtstring<date-time>مطلوب
  وقت إنشاء المنشور
- targetsobject[]مطلوب
  مدخل لكل شبكة وحساب: حسابان على شبكة واحدة، مدخلان
  عرض الخصائص الفرعية
  - platformstringمطلوب
    شبكة الهدف
  - accountIdstringمطلوب
    الحساب الذي ينشر (GET /v1/establishments/:id/accounts)
  - statestringمطلوب
    حالة الهدف على شبكته
    القيم المسموحة: draftscheduledpublishingpublishedsent_to_inboxfailed
  - publishedAtstring<date-time>
    وقت نشر الهدف
  - permalinkstring
    رابط المنشور المنشور على الشبكة
  - errorstring
    سبب رفض الشبكة
- scheduledAtstring<date-time>
  وقت جدولة نشر المنشور
nextCursorstring
مرّره كـ ?cursor= للصفحة التالية؛ يغيب في النهاية

هل كانت هذه الصفحة مفيدة؟