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

المنشورات

عدّل منشورًا

قبل أن تبدأ أي شبكة بالإرسال، يستبدل targets أو يضبط scheduledAt أو ينقل المنشور بين draft وscheduled. تبقى الحقول المحذوفة كما هي.

PATCHhttps://api.sofia-post.com/api/v1/posts/{id}
PATCH/v1/posts/{id}

يؤثر هذا الطلب على حسابك الحقيقي.

curl -X PATCH 'https://api.sofia-post.com/api/v1/posts/{id}' \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"scheduledAt":"2026-11-02T10:00:00.000Z"}'

التفويضات

  • Authorizationstringمطلوب

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

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

  • idstringمطلوب

    معرّف المنشور.

الجسم

application/json

  • targetsobject[]

    كل الأهداف، معاد كتابتها (النص والوسائط والصيغة والحساب)؛ عند الغياب: تبقى

    عرض الخصائص الفرعية
    • platformstringمطلوب

      الشبكة المستهدفة

      القيم المسموحة: instagramfacebookxlinkedintiktok

    • textstringمطلوب

      النص المصاحب المنشور على هذه الشبكة

    • mediaobject[]

      الوسائط المرفقة

      عرض الخصائص الفرعية
      • idstring

        معرّف وسائط من مكتبة المنشأة (وإلا url وtype)

      • urlstring

        العنوان العام للوسائط (https في الوضع الفعلي)؛ دون معرّف

      • typestring

        نوع الوسائط المعطاة بعنوان

        القيم المسموحة: imagevideo

    • formatstring

      الصيغة (post وreel وstory وcarousel...)؛ افتراضيًا الصيغة التي تقدمها الشبكة

    • accountIdstring

      في الوضع الفعلي: الحساب المتصل الذي ينشر، عندما تملك المنشأة عدة حسابات على هذه الشبكة (GET /v1/establishments/:id/accounts)

  • scheduledAtstring<date-time>

    موعد جديد، في المستقبل: يُجدول المنشور في هذا الموعد

  • statusstring

    draft: العودة إلى مسودة (يبقى المحتوى ويضيع الموعد)؛ scheduled: الجدولة في scheduledAt، أو في الموعد الذي كان له

    القيم المسموحة: draftscheduled

الاستجابة

200application/json

المنشور بعد التعديل.

  • 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>

    وقت جدولة نشر المنشور

402

subscription_required.

403

live_mode_required لتطبيق اختباري، أو أن النطاق posts:write مفقود.

404

post_not_found: خارج نطاق وصول الرمز.

409

post_not_editable: أُرسلت شبكة أو يجري إرسالها.

422application/json

post_refused: سترفض شبكة أو المنشأة أو النشر المنشور المعدَّل. duplicate_platform لهدفين على شبكة واحدة.

4XXapplication/json

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