> ## Documentation Index
> Fetch the complete documentation index at: https://ayrshare.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# نظرة عامة على واجهة برمجة تطبيقات التعليقات

> نشر التعليقات والرد عليها واسترجاعها وحذفها على منشور اجتماعي

export const PlansAvailable = ({plans = [], maxPackRequired}) => {
  let displayPlans = plans;
  if (plans && plans.length === 1) {
    const lowerCasePlan = plans[0].toLowerCase();
    if (lowerCasePlan === "business") {
      displayPlans = ["Launch", "Business", "Enterprise"];
    } else if (lowerCasePlan === "premium") {
      displayPlans = ["Premium", "Launch", "Business", "Enterprise"];
    }
  }
  return <Note>
Available on {displayPlans.length === 1 ? "the " : ""}
{displayPlans.join(", ").replace(/\b\w/g, l => l.toUpperCase())}{" "}
{displayPlans.length > 1 ? "plans" : "plan"}.

{maxPackRequired && <span onClick={() => window.open('https://www.ayrshare.com/docs/additional/maxpack', '_self')} className="flex items-center mt-2 cursor-pointer">
 <span className="px-1.5 py-0.5 rounded text-sm" style={{
    backgroundColor: '#C264B6',
    color: 'white',
    fontSize: '12px'
  }}>
   Max Pack required
 </span>
</span>}
</Note>;
};

<PlansAvailable plans={["premium"]} maxPackRequired={false} />

تسمح نقاط نهاية التعليقات لمستخدميك بنشر التعليقات والرد عليها واسترجاعها وحذفها على منشوراتهم.
توجد أربعة أنواع من معرّفات التعليقات: معرّف منشور Ayrshare، ومعرّف المنشور الاجتماعي، ومعرّف تعليق Ayrshare، ومعرّف التعليق الاجتماعي.
يُستخدم كل من هذه المعرّفات لأغراض مختلفة.

## أنواع معرّفات التعليقات

### التعليقات باستخدام معرّف منشور Ayrshare

التدفّق النموذجي هو أنه عند نشر منشور عبر Ayrshare، تحصل على معرّف منشور Ayrshare.
يمكنك بعد ذلك استخدام هذا [معرّف منشور Ayrshare](/apis/overview#ayrshare-post-id) لإدارة التعليقات على ذلك المنشور.

المنصات المدعومة: Bluesky وFacebook Pages وInstagram وLinkedIn وReddit وThreads وTikTok وTwitter وYouTube.

على سبيل المثال:

<Steps>
  <Step title="نشر منشور">
    استخدم نقطة النهاية [/post](/apis/post/post) لنشر منشور عبر Ayrshare، والذي يمكن إرساله إلى شبكات تواصل اجتماعي متعددة في استدعاء واحد.

    في القيمة المُعادة، يوجد [معرّف منشور Ayrshare](/apis/overview#ayrshare-post-id) على المستوى الأعلى.

    ```json {12} theme={"system"}
    {
        "status": "success",
        "errors": [],
        "postIds": [
        {
            "status": "success",
            "id": "106638148652329_591370753547555",
            "postUrl": "https://www.facebook.com/106638148652329/posts/591370753547555",
            "platform": "facebook"
        }
        ],
        "id": "E4UdUr1yRbvI7qqCSlaq", // Ayrshare Post ID
        "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc055",
        "post": "What an amazing day",
        "validate": true
    }
    ```
  </Step>

  <Step title="نشر تعليق">
    استخدم نقطة النهاية [/comments](/apis/comments/post-comment) لنشر تعليق باستخدام معرّف منشور Ayrshare.
    سيتم نشر التعليق تلقائيًا على كل شبكة تواصل اجتماعي نُشر عليها المنشور الأصلي.
    على سبيل المثال، إذا نشرت المنشور على Facebook وInstagram، سيظهر التعليق على كلتا المنصتين.

    ```http theme={"system"}
    POST https://api.ayrshare.com/api/comments/:id
    ```
  </Step>

  <Step title="الحصول على التعليقات">
    استخدم نقطة النهاية [/comments](/apis/comments/get-comments) للحصول على التعليقات للمنشور باستخدام معرّف منشور Ayrshare.
    سيؤدي هذا إلى إعادة جميع التعليقات من كل شبكة تواصل اجتماعي نُشر عليها المنشور.
    على سبيل المثال، إذا نشرت على Facebook وInstagram، فستحصل على التعليقات من كلتا المنصتين.

    ```http theme={"system"}
    GET https://api.ayrshare.com/api/comments/:id
    ```
  </Step>
</Steps>

### التعليقات باستخدام معرّف المنشور الاجتماعي

في بعض الأحيان قد ترغب في إدارة التعليقات على منشور لم يُنشر عبر Ayrshare.
في هذه الحالة يمكنك استخدام [معرّف المنشور الاجتماعي](/apis/overview#social-post-id)، وهو معرّف المنشور المُعيَّن من قبل شبكة التواصل الاجتماعي.

<Note>
  إذا كان المنشور قد نُشر عبر Ayrshare، فاستخدم [معرّف منشور
  Ayrshare](/apis/comments/overview#comments-with-ayrshare-post-id).
</Note>

على سبيل المثال:

<Steps>
  <Step title="الحصول على سجل المنشورات">
    ابدأ بالحصول على منشورات Instagram المنشورة خارج Ayrshare باستخدام [نقطة نهاية الحصول على كامل سجل المنشورات](/apis/history/history-platform).

    تُعيد نقطة النهاية قائمة بالمنشورات مع `id` الاجتماعي للمنشور.

    ```json {13} theme={"system"}
    {
        "status": "success",
        "posts": [
            {
                "mediaUrl": "https://scontent.cdninstagram.com/v/t51.2885-15/7531.jpg",
                "permalink": "https://www.instagram.com/p/B5OBT3ygpfg/",
                "commentsCount": 0,
                "created": "2022-05-20T17:26:03Z",
                "likeCount": 0,
                "mediaProductType": "FEED",
                "mediaType": "IMAGE",
                "username": "thegoodone",
                "id": "17833140557332933", // Instagram Social Post ID
                "thumbnailUrl": "https://scontent-lga3-2.cdninstagram.com/v/t51..jpg",
                "post": "The #Mandalorian is on tonight instead of Friday",
                "postUrl": "https://www.instagram.com/p/B5OBT3ygpfg/"
            },
        ]
    }
    ```

    <Note>يُعاد `id` المنشور الاجتماعي أيضًا في حقل `postIds` من [نقطة نهاية post](/apis/post/post).</Note>
  </Step>

  <Step title="الحصول على التعليقات على المنشور">
    استخدم `id` المُعاد [للحصول على جميع التعليقات](/apis/comments/get-comments) لمنشور Instagram محدد باستخدام `id` الاجتماعي، مع تعيين `searchPlatformId` إلى `true` و`platform` إلى `instagram`.

    ```http theme={"system"}
    GET https://api.ayrshare.com/api/comments/17833140557332933?platform=instagram&searchPlatformId=true
    ```
  </Step>

  <Step title="استخدام معرّف التعليق للحصول على تفاصيل التعليق">
    سيحتوي JSON المُعاد من الخطوة السابقة على `commentId` لكل تعليق، وهو [معرّف التعليق الاجتماعي](/apis/overview#social-comment-id).

    ```json {5} theme={"system"}
    {
        "instagram": [
            {
                "comment": "What an amazing comment",
                "commentId": "17969247335804735", // Social Comment ID
                "created": "2024-11-26T11:49:00Z",
                "from": {
                "id": "103038435208332",
                "username": "john_smith"
                },
                "hidden": false,
                "likeCount": 3,
                "platform": "instagram",
                "postId": "18231730279304333",
                "username": "john_smith"
            }
        ]
    }

    ```
  </Step>
</Steps>

### التعليقات باستخدام معرّف تعليق Ayrshare

أدر التعليقات على منشور نُشر عبر Ayrshare باستخدام [معرّف تعليق Ayrshare](/apis/overview#ayrshare-comment-id).
معرّف تعليق Ayrshare هو معرّف التعليق المُعيَّن من Ayrshare ويمكن العثور عليه في حقل `commentId` في الاستجابة عند [نشر تعليق](/apis/comments/post-comment).

يُستخدم هذا غالبًا إذا كنت تريد الحصول على تفاصيل حول تعليق معين نُشر عبر Ayrshare.

### التعليقات باستخدام معرّف التعليق الاجتماعي

أدر التعليقات على منشور لم يُنشر عبر Ayrshare باستخدام [معرّف التعليق الاجتماعي](/apis/overview#social-comment-id).
معرّف التعليق الاجتماعي هو معرّف التعليق من شبكة التواصل الاجتماعي، وليس معرّف Ayrshare، ويمكن العثور عليه في حقل `commentId` في الاستجابة عند [الحصول على التعليقات](/apis/comments/get-comments).

```http theme={"system"}
GET https://api.ayrshare.com/api/comments/17969247335804735?platform=instagram&searchPlatformId=true&commentId=true
```

يُستخدم هذا غالبًا إذا كنت تريد الحصول على تفاصيل حول تعليق معين نُشر خارج Ayrshare، مثل ردود LinkedIn على التعليقات.

## تعطيل التعليقات

يمكنك تعطيل التعليقات عند نشر منشور باستخدام حقل `disableComments` في [نقطة نهاية /post](/apis/post/post). سيتم تعطيل التعليقات فقط لـ Instagram وLinkedIn وTikTok.

يمكنك أيضًا تفعيل أو تعطيل التعليقات على منشور تم نشره بالفعل باستخدام نقطة نهاية [تحديث المنشور](/apis/post/update-post) وحقل `disableComments`.

## قيود المنصة

<Note>
  **TikTok — `DELETE /comments` للتعليقات التي تكتبها بنفسك فقط.** تنجح [`DELETE /comments`](/apis/comments/delete-comments) على TikTok فقط للتعليقات التي كتبها حساب TikTok المُصادق عليه ذاته (ردودك الخاصة). محاولة حذف تعليق كتبه مستخدم آخر تُرجع رمز Ayrshare `code: 328`. لإدارة تعليقات طرف ثالث على مقاطع فيديو TikTok الخاصة بك، اتصل بالدعم لكي نتمكن من تأكيد ما هو متاح لنوع حسابك المربوط.
</Note>

```
```