تحليلات القناة
GET /public/v1/analytics/{integration}يعيد ما تبلغ عنه المنصة لقناة واحدة: المتابعون، ومرات الظهور، والتفاعل، وما تتيحه تلك المنصة أيًا كان. والمقاييس تختلف باختلاف المزود، لذا تعيد هذه العملية سلاسل مسماة لا مخططًا ثابتًا.
إن كنت تفعل ذلك من التطبيق، فراجع التحليلات. وهذه العملية متاحة
أيضًا بالأمر sharek analytics:platform في أداة
CLI من شارك، ولا تقابلها أداة في خادم MCP.
معاملات المسار
Section titled “معاملات المسار”| المعامل | مطلوب | الوصف |
|---|---|---|
integration |
نعم | معرف القناة من سرد القنوات، لا اسم المزود. |
معاملات الاستعلام
Section titled “معاملات الاستعلام”| المعامل | مطلوب | الوصف |
|---|---|---|
date |
لا | كم يومًا للوراء تغطى، كرقم. 7 أو 30 أو 90. والقيمة الافتراضية 7، وهي أيضًا ما تحصل عليه لأي قيمة ليست رقمًا موجبًا. |
curl -H "Authorization: your-api-key" \ "https://dash.sharek.app/api/public/v1/analytics/channel-id?date=30"الاستجابة
Section titled “الاستجابة”[ { "label": "Reach", "percentageChange": 0, "data": [ { "total": 0, "date": "2026-08-18" }, { "total": 0, "date": "2026-08-19" } ] }]| الحقل | الوصف |
|---|---|
label |
اسم المقياس، يختاره المزود. فقناة Instagram قد تعيد Follower Count وReach وLikes وViews وComments وShares وSaves وReplies؛ ومزودون آخرون يعيدون مجموعتهم الخاصة. |
data |
السلسلة اليومية. |
percentageChange |
دائمًا 0 حاليًا: فلا مزود يحسبه بعد، فلا تبن عليه. |
المصفوفة الفارغة شائعة
Section titled “المصفوفة الفارغة شائعة”تعاد []، بلا خطأ، حين:
- لا يتيح المزود تحليلات. وكثيرون لا يتيحونها.
- لا تكون القناة قناة اجتماعية.
- ينتهي رمز القناة ويتعذر تجديده. وفي تلك الحالة يقطع اتصال القناة أيضًا وتظهر بأنها تحتاج انتباهًا في التطبيق.
فتحقق من [] قبل أن تفترض أن في التكامل خللًا.
التخزين المؤقت
Section titled “التخزين المؤقت”الاستجابات تخزن مؤقتًا ساعة واحدة لكل قناة ولكل عدد أيام. والسؤال مرة أخرى داخل تلك الساعة يعيد الأرقام نفسها، فلا فائدة من تكرار الطلب بوتيرة أعلى.
الأخطاء
Section titled “الأخطاء”| الاستجابة | المعنى |
|---|---|
500 |
معرف القناة لا يخص مؤسستك. ويظهر ذلك كخطأ خادم لا كـ 404. |
ولأرقام منشور واحد بدل أرقام القناة، استخدم تحليلات المنشور.