تخطَّ إلى المحتوى

العثور على المحتوى المفقود

GET /public/v1/posts/{id}/missing

بعض المنصات تنشر بنجاح لكنها لا تخبر شارك أي عنصر أنشئ. وحين يحدث ذلك يضع شارك القيمة missing في releaseId الخاص بالمنشور، ولا يمكن جلب تحليلاته، لأنه لا يوجد معرف على المنصة يسأل عنه.

وهذه العملية تسرد العناصر المرشحة على المنصة لتختار الصحيح منها، ثم تسجله بـ تحديث معرف الإصدار.

وهذه العملية متاحة أيضًا بالأمر sharek posts:missing في أداة CLI من شارك، ولا تقابلها أداة في خادم MCP.

المعامل مطلوب الوصف
id نعم معرف المنشور.
Terminal window
curl -H "Authorization: your-api-key" \
https://dash.sharek.app/api/public/v1/posts/post-id/missing
[
{ "id": "platform-item-id", "url": "https://platform.example/p/123" },
{ "id": "another-item-id", "url": "https://platform.example/p/122" }
]

افتح الروابط، وقرر أيها منشورك، وأرسل قيمة id تلك إلى تحديث معرف الإصدار.

المصفوفة الفارغة هي الحالة الطبيعية

Section titled “المصفوفة الفارغة هي الحالة الطبيعية”

[] تعود كلما لم يكن هناك ما يحل، وهو ما يغطي حالات عدة ليست أخطاءً:

  • المنشور نشر بشكل طبيعي وله releaseId حقيقي بالفعل.
  • المنشور لم ينشر بعد.
  • مزود المنشور لا يدعم هذا البحث أصلًا. ومعظمهم لا يدعمه.

ومن ثم فـ [] تعني «لا شيء عليك فعله هنا»، لا «حدث خطأ ما».

  1. تحليلات المنشور تجيب {"missing": true}.
  2. استدع هذه العملية لسرد المرشحين.
  3. حدد منشورك واستدع تحديث معرف الإصدار بمعرفه.
  4. تعمل التحليلات من تلك اللحظة.
  • يجدد شارك رمز وصول القناة أولًا إن كان منتهيًا. فإن فشل التجديد، كان الجواب [] واحتاجت القناة إعادة ربط في التطبيق.