المنشورات

عدّل منشورًا

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

PATCHhttps://api.sofia-post.com/api/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"}'

{
  "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 PATCH \
  --url 'https://api.sofia-post.com/api/v1/posts/<id>' \
  --header "Authorization: Bearer $SOFIA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "scheduledAt": "2026-11-02T10:00:00.000Z"
}'

{
  "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"
    }
  ]
}

PATCH /v1/posts/{id} يعيد كتابة الأهداف أو ينقل scheduledAt أو يغيّر status: draft يزيل الموعد ويحتفظ بالمحتوى، وscheduled يعيد جدولته. بعد أن ترسل شبكة المنشور، يكون الرد 409 post_not_editable.

curl -X PATCH https://api.sofia-post.com/api/v1/posts/$POST_ID \
  -H "Authorization: Bearer $SOFIA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"status":"scheduled","scheduledAt":"2026-11-20T09:00:00Z"}'

التفويضات

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

الاستجابة

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

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>
وقت جدولة نشر المنشور

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