المنشورات

اعرض منشورًا

يعيد منشورًا مع حالة كل شبكة ورابطه بعد النشر وخطئه إن فشل. يقرأ الوضع الفعلي أي منشور في مساحة العمل، والاختباري منشورًا محاكى.

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

اعرض منشورًا

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

{
  "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/<id>' \
  --header "Authorization: Bearer $SOFIA_API_KEY"

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

اقرأ منشورًا لتتابع حالة كل شبكة من شبكاته: تنتقل كل شبكة هدف إلى published مع رابطها الدائم، أو إلى failed مع سببها. ولتُنبَّه دون استطلاع API، سجّل webhook.

{
  "id": "efc578cc-ef79-40e9-876d-be1a33d3b8db",
  "status": "published",
  "targets": [
    {
      "platform": "instagram",
      "state": "published",
      "publishedAt": "2026-11-02T20:17:25.453Z",
      "permalink": "https://www.instagram.com/p/DfQJVPGFfb_/"
    }
  ]
}

الحالات

الحالة	المعنى
`draft`	محفوظ، لا يُنشر
`scheduled`	سيُنشر في `scheduledAt`
`publishing`	قيد الإرسال إلى الشبكة
`published`	على الإنترنت، مع `permalink` الخاص به
`failed`	رفضته الشبكة؛ و`error` يبيّن السبب
`sent_to_inbox`	أُرسل إلى تطبيق الشبكة، حيث يُنهيه المالك (TikTok)

status المنشور يلخّص أهدافه. قيمته partial حين تنشر شبكة وتفشل أخرى.

التفويضات

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

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

idstringمطلوب
معرّف المنشور.

الاستجابة

المنشور وحالة كل هدف.

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

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