المنشوراتاعرض المنشورات
العودة إلى Sofia

المنشورات

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

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

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

التفويضات

  • Authorizationstringمطلوب

    مفتاحك الشخصي أو رمز وصول 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).

الاستجابة

200application/json

صفحة منشورات، مع 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= للصفحة التالية؛ يغيب في النهاية

400

invalid_cursor، أو invalid_request لمعامل مشوّه.

401

الرمز مفقود أو غير معروف أو منتهي الصلاحية أو ملغى.

403

لا يملك الرمز النطاق posts:read.

404

establishment_not_found: المنشأة خارج نطاق وصول الرمز.

4XXapplication/json

أي خطأ آخر، ضمن غلاف الخطأ.