Skip to main content
GET
احصل على التعليقات لمنشور باستخدام معرّف منشور Ayrshare، أو معرّف المنشور الاجتماعي، أو معرّف تعليق Ayrshare، أو معرّف التعليق الاجتماعي مع Comment API. يرجى الاطلاع على نظرة عامة على التعليقات لمزيد من المعلومات حول أنواع المعرّفات المختلفة.
عند استخدام معرّف منشور Ayrshare، لا توجد معلمات استعلام مطلوبة.

تفاصيل إضافية للتعليقات

  • يتم تحديث بيانات التعليقات كل 10 دقائق لجميع المنصات، باستثناء X. بسبب القيود التي تفرضها X API، يتم تحديث بيانات التعليقات لـ X باستخدام استراتيجية التراجع الأسي (exponential backoff)، مما يعني أن الفترات بين التحديثات تزداد تدريجيًا بمرور الوقت.
  • على X، يؤدي طلب التعليقات لمنشور هو نفسه رد إلى إعادة الردود على ذلك المنشور. أما منشور X الذي يبدأ محادثته الخاصة فلم يتغيّر، ولا يزال يُعيد الردود من كامل تلك المحادثة.
  • في استجابة Facebook، ردود التعليقات على الردود لها دائمًا نفس parent.id.
  • استرجع ردود LinkedIn على التعليقات بتعيين معلمات الاستعلام "commentId": true و "searchPlatformId": true وتقديم معرّف التعليق الاجتماعي في معلمة المسار.
  • يُعيد Facebook وInstagram أحدث 1,000 تعليق على المنشور. يرجى الاتصال بنا بشأن حدود أعلى في خطة Enterprise.
  • بالنسبة لمنشور TikTok الذي لا يزال قيد المعالجة (id الخاص به هو "pending")، يُعيد get-comments خطأً واضحًا “لا يزال قيد المعالجة” (code: 288، HTTP 400) بدلاً من فشل عام. أعد المحاولة بمجرد إطلاق webhook tikTokPublished أو ظهور معرّف الفيديو المُحلَّل في /history.

القراءات متعددة المنصات والنجاح الجزئي

عندما تطلب التعليقات باستخدام معرّف منشور Ayrshare، قد يمتد المنشور عبر عدة منصات. يُوزّع Ayrshare طلبًا واحدًا (“ساق”) لكل منصة ويُعيد نجاحًا جزئيًا إذا نجحت بعض الأرجل وفشلت أخرى — تُعاد دائمًا بيانات تعليقات المنصات السليمة، وتُعدَّد كل ساق فاشلة في مصفوفة errors[] على المستوى الأعلى.
  • تنجح بعض المنصات وتفشل أخرى: الاستجابة هي HTTP 200 مع status: “partial”. تُعاد كتل المنصات السليمة كالمعتاد، وتسرد مصفوفة errors[] على المستوى الأعلى كل ساق فاشلة مع platform وstatus وcode وmessage وid الخاصة بها.
  • تفشل كل منصة: الاستجابة تحتوي على status: “error” ومصفوفة errors[] الكاملة. تُطابق حالة HTTP من رمز الخطأ التمثيلي على المستوى الأعلى. الرمز 485 يُطابق HTTP 404؛ الرموز التمثيلية الأخرى تستخدم مطابقاتها الخاصة.
  • تنجح كل المنصات: الاستجابة لم تتغير — HTTP 200، status: “success”، وبدون مفتاح errors[].
تغيير في السلوك — افحص errors[]، ولا تتفرع بناءً على حالة HTTP. بما أن القراءة متعددة المنصات التي تحتوي على ساق فاشلة تُعيد الآن HTTP 200 بدلاً من تقليص الاستجابة بأكملها إلى خطأ، يجب على المُدمجين دائمًا التحقق من وجود مصفوفة errors[] على المستوى الأعلى لاكتشاف الإخفاقات لكل منصة بدلاً من الاعتماد على رمز حالة HTTP وحده.

تعليقات Instagram / Facebook Story منتهية الصلاحية أو غير المتاحة

ساق تعليقات Instagram أو Facebook Story التي تكون منتهية الصلاحية أو غير متاحة — بحيث لا يمكن استرداد تعليقاتها — تظهر في errors[] بالرمز 485. رسالة تمثيلية لـ Instagram هي “Instagram Story expired or unavailable — comments/insights cannot be retrieved.” إذا نجحت منصة أخرى، تظل تعليقاتها تُعاد وتكون الاستجابة الإجمالية HTTP 200. لاستجابة فشل كامل، الرمز التمثيلي 485 يُطابق HTTP 404؛ الرموز التمثيلية الأخرى تستخدم مطابقاتها الخاصة. طابق على code (485)، وليس على نص الرسالة الحرفي.

مثال: استجابة نجاح جزئي

200: نجاح جزئي

إخفاقات الفوترة وحدود المعدل على X

قد تفشل قراءة التعليقات لـ X على حساب X Developer الخاص بك، وغالبًا ما يكون السبب نفاد أرصدة API لديه، أو وصولك إلى حد المعدل الذي تفرضه X. تُعيد هذه الإخفاقات خطأً محدد النوع بدلًا من قائمة تعليقات فارغة، فلا تُفسَّر مشكلة في الحساب أبدًا على أنها منشور بلا تعليقات.
  • تُعيد X حالة HTTP 402 (لا توجد أرصدة API): يُعيد Ayrshare code: 416 مع HTTP 402.
  • تُعيد X حالة HTTP 429 (حد المعدل): يُعيد Ayrshare code: 364 مع HTTP 429. وعندما تشير استجابة 429 من X إلى نفاد أرصدة الحساب، يُعيد Ayrshare code: 416 بدلًا من ذلك، لأن الانتظار لن يحل المشكلة.
  • إخفاقات التفويض تُعيد code: 272، وأي إخفاق آخر من X يُعيد code: 219، وكلاهما مع HTTP 400.
في القراءة متعددة المنصات، تحمل الاستجابة status: “partial” على المستوى الأعلى، وتظهر ساق X الفاشلة في errors[] مع status: “error”، تمامًا كما هو موضح أعلاه؛ أما القراءة من منصة واحدة فتُعيد الخطأ على المستوى الأعلى. وعندما ترفض X الطلب مباشرةً، لا يُخزَّن الإخفاق مؤقتًا، لذا تُعاد محاولة القراءة بمجرد أن تطلب التعليقات مرة أخرى. منشور X المحذوف، أو الذي لا تستطيع بيانات اعتماد X الخاصة بك رؤيته، لا يزال يُعيد مصفوفة فارغة دون خطأ.

معلمات الترويسة

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

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

boolean
افتراضي:false
عند الحصول على التعليقات على منشور تم نشره عبر Ayrshare واستخدام معرّف منشور Ayrshare، لا تُضمِّن هذا الحقل - القيمة الافتراضية هي false. عند الحصول على التعليقات باستخدام معرّف المنشور الاجتماعي أو معرّف التعليق الاجتماعي، وهو المعرّف الذي تُنشئه شبكات التواصل الاجتماعي، عيّنه على true.
boolean
افتراضي:false
إذا كنت تحصل على التعليقات باستخدام معرّف التعليق الاجتماعي، وهو معرّف التعليق الذي تُنشئه شبكات التواصل الاجتماعي، عيّنه على true.إذا كنت تحصل على تعليق باستخدام معرّف منشور Ayrshare أو معرّف المنشور الاجتماعي، لا تُضمِّن هذا الحقل - القيمة الافتراضية هي false.
عند استخدام معلمة الاستعلام commentId، يجب أيضًا تعيين searchPlatformId على true.
string
مطلوب إذا كان searchPlatformId أو commentId هو true.متى تستخدمه:
  • عند استخدام معرّف المنشور الاجتماعي وحقل "searchPlatformId": true. المنصات المدعومة: bluesky وfacebook وinstagram و linkedin وthreads وtiktok وtwitter وyoutube.
  • عند استخدام معرّف التعليق الاجتماعي وحقلي "searchPlatformId": true و"commentId": true. المنصات المدعومة: facebook و instagram وlinkedin.
  • عند استخدام معرّف منشور Ayrshare، لا تُضمِّن هذا الحقل - ستتم إعادة التعليقات من جميع المنصات التي نُشر عليها المنشور الأصلي.

أمثلة على طلب GET للتعليقات