تحليلات المنشور
GET /public/v1/analytics/post/{postId}يعيد أرقام المنصة لمنشور واحد تم نشره: الوصول، والتفاعل، وما يبلغ عنه ذلك المزود لكل عنصر أيًا كان.
إن كنت تفعل ذلك من التطبيق، فراجع التحليلات. وهذه العملية متاحة
أيضًا بالأمر sharek analytics:post في أداة CLI من
شارك، ولا تقابلها أداة في خادم MCP.
معاملات المسار
Section titled “معاملات المسار”| المعامل | مطلوب | الوصف |
|---|---|---|
postId |
نعم | معرف المنشور من إنشاء منشور أو سرد المنشورات. |
معاملات الاستعلام
Section titled “معاملات الاستعلام”| المعامل | مطلوب | الوصف |
|---|---|---|
date |
نعم | كم يومًا للوراء تغطى، كرقم. |
curl -H "Authorization: your-api-key" \ "https://dash.sharek.app/api/public/v1/analytics/post/post-id?date=30"الاستجابة
Section titled “الاستجابة”الشكل نفسه الذي في تحليلات القناة:
[ { "label": "Impressions", "percentageChange": 0, "data": [ { "total": 3402, "date": "2026-09-01" } ] }]وtotal ليس محدد النوع بشكل موثوق: فتعريف النوع يعلنه نصًا والإنتاج يعيد أرقامًا، فاجعله رقمًا بـ
Number(...) قبل إجراء أي حساب.
استجابة {"missing": true}
Section titled “استجابة {"missing": true}”{ "missing": true }هذه ليست خطأً وليست نتيجة فارغة. بل تعني أن المنشور نشر، لكن شارك لم يستطع تحديد أي عنصر على المنصة صار إليه، فلا شيء يسأل عن أرقامه.
أصلحها في ثلاث خطوات:
- استدع المحتوى المفقود لمعرف المنشور نفسه لسرد العناصر المرشحة.
- استنتج أيها منشورك من الروابط العائدة.
- أرسل ذلك المعرف إلى تحديث معرف الإصدار.
وتعمل التحليلات من تلك اللحظة.
المصفوفة الفارغة
Section titled “المصفوفة الفارغة”[] تعني أنه لا شيء يبلغ عنه بعد، وغالبًا لأن المنشور لم ينشر أو لأن المزود لا يبلغ
عن مقاييس لكل منشور.