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

# Instagram API

> خيارات النشر باستخدام Instagram API

<Info>
  إذا واجهت مشاكل في ربط Instagram، يُرجى مراجعة [دليل استكشاف الأخطاء
  وإصلاحها](/help-center/technical-support/facebook_or_instagram_linking_issues).
</Info>

<Info>
  إذا كانت وسائطك مستضافة على خادم أو CDN تتحكّم فيه، فتأكّد من أن زاحف النشر الخاص بـ Meta
  يمكنه جلبها. راجع [Meta Media Crawler Blocked](/help-center/technical-support/meta_media_crawler_blocked)
  إذا رأيت رمز خطأ Ayrshare رقم 440 ("social network could not download media from this URL") أو رمز الخطأ 138 مع "Restricted by robots.txt" في التفاصيل.
</Info>

<div class="video-container">
  <iframe width="380" height="200" src="https://www.youtube.com/embed/3F7mbVN0qrw" title="Posting to Instagram API" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" />
</div>

يحتوي Instagram API على المتطلبات والقيود التالية.

<ul class="custom-bullets">
  <li>
    حساب Instagram من نوع Business أو Creator مرتبط بصفحة Facebook - [راجع
    هنا](/dashboard/connect-social-accounts/instagram).
  </li>

  <li>يُسمح بـ 50 منشور Instagram فقط خلال فترة 24 ساعة. راجع أدناه بشأن `usedQuota`</li>

  <li>
    قد يحتوي نص `post` على *حتى 5 هاشتاغات* (على سبيل المثال #wildtimes) و\_3 إشارات إلى أسماء مستخدمين\_
    (على سبيل المثال @natgeo).
  </li>

  <li>سيتلقّى مستخدمو Instagram الذين تم @الإشارة إليهم إشعارًا.</li>
  <li>الحد الأقصى 2,200 حرف للمنشور.</li>

  <li>
    المنشورات متعدّدة الصور/الفيديوهات مدعومة وتُرسل كـ carousel. يمكنك إرسال ما يصل إلى 10 فيديوهات
    وصور.
  </li>

  <li>
    لا يدعم Instagram الحذف عبر API. يجب أن يتم الحذف يدويًا باستخدام تطبيق
    Instagram.
  </li>

  <li>
    إذا كان فيديو Reel الخاص بك لا ينتهي بامتداد فيديو معروف مثل mp4، فيُرجى استخدام معلمة
    `isVideo`. راجع [نقطة النهاية /post](/apis/post/post) للحصول على التفاصيل.
  </li>

  <li>
    يدعم Instagram أيضًا إرسال الوسائط دون نص منشور. إذا كنت لا ترغب في تضمين نص المنشور
    أرسل سلسلة فارغة `post: ""`.
  </li>

  <li>راجع [إرشادات وسائط Instagram](/media-guidelines/instagram) و[تفويض Instagram](/dashboard/connect-social-accounts/instagram) لمزيد من المعلومات.</li>
</ul>

## النشر إلى Instagram

JSON لمنشور أساسي مع صورة وهاشتاغات إلى Instagram:

```json Instagram Post theme={"system"}
{
  "post": "The best IG ever #best #awesome https://www.instagram.com",
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
  "platforms": ["instagram"]
}
```

الهاشتاغات قابلة للنقر في منشورات Instagram، لكن الروابط ليست كذلك.

<Note>
  نسبة العرض إلى الارتفاع للصور والفيديوهات ومدة الفيديو مهمّة جدًا للنشر بنجاح إلى Instagram. إذا لم تفِ بالمتطلبات، فسيُرفض المنشور.

  [يُرجى الاطلاع على قسم Instagram في إرشادات الصور والفيديوهات](/media-guidelines/instagram).
</Note>

## حساب Instagram Business أو Creator

يجب أن يكون حساب Instagram الخاص بك حسابًا من نوع Business أو Creator ومرتبطًا بصفحة Facebook. الإعداد مجاني وسهل.

راجع هنا للحصول على تعليمات مفصّلة:

<Card title="ربط Instagram" icon="link" href="/dashboard/connect-social-accounts/instagram" horizontal />

## Carousel من الصور والفيديوهات

يمكنك نشر عدّة صور أو فيديوهات Reel إلى Instagram على شكل carousel؛ يمكن استخدام ما يصل إلى إجمالي 10 صور أو فيديوهات في carousel.
فقط أضف صورك أو فيديوهاتك الإضافية إلى مصفوفة `mediaUrls` وسيتمّ إنشاء carousel تلقائيًا.

```json Instagram Carousel Post theme={"system"}
{
  // Max 10 images or videos
  "mediaUrls": ["https://url.com/image.jpg", "https://url.com/video.mp4"]
}
```

<Note>
  يجب أن تنتهي عناوين URL للفيديو بامتداد معروف مثل `mp4`. معلمة `isVideo` غير مدعومة
  لـ carousels Instagram.
</Note>

## Instagram Reels

في Instagram يُطلق على منشور الفيديو اسم Reel.
يمكنك نشر فيديو إلى Instagram Reels API باستخدام خيارات `instagramOptions` الاختيارية التالية.

```json Instagram Reels Options theme={"system"}
{
  "instagramOptions": {
    "shareReelsFeed": true,
    "audioName": "The Weeknd - Blinding Lights",
    "thumbNail": "https://img.ayrshare.com/012/gb.jpg", // if used, thumbNailOffset will be ignored.
    "thumbNailOffset": 30000
  }
}
```

<ul class="custom-bullets">
  <li>
    يُرجى الاطلاع على [متطلبات فيديو Reels API](/media-guidelines/instagram#reels) للحصول على تفاصيل
    حول متطلبات الفيديو.
  </li>

  <li>
    `shareReelsFeed`: قيمة Boolean تُعيَّن إلى `true` للإشارة إلى أن الـ Reel *يمكن* أن يظهر في كلٍّ من علامتَي
    **Feed** و**Reels** أو `false` للإشارة إلى أن الـ Reel *يمكن* أن يظهر فقط في علامة تبويب **Reels**.
    هذه القيمة تلميح لـ Instagram حول المكان الذي تريد ظهور الـ Reel فيه، لكن
    لا تحدّد أيّ منهما ما إذا كان الـ Reel *يظهر فعلاً* في علامة تبويب **Reels** أو **Feed** لأن
    الـ Reel قد لا يستوفي متطلبات الأهلية أو قد لا تختاره خوارزمية Instagram.
  </li>

  <li>
    `audioName`: اسم String لصوت الموسيقى في وسائط الـ Reels الخاصة بك. يمكنك إعادة التسمية مرة واحدة فقط، إمّا
    أثناء إنشاء ريل أو بعد ذلك من صفحة الصوت. على سبيل المثال، `"The Weeknd - Blinding
            Lights"`.
  </li>

  <li>
    `thumbNail`: عنوان URL من نوع String لصورة غلاف الـ Reel (الصورة المصغّرة). يُرجى الاطلاع على [تفاصيل
    thumbNail](/apis/post/social-networks/instagram#reels-thumbnails).
  </li>

  <li>
    `thumbNailOffset`: إزاحة Integer بالمللي ثانية لإطار الصورة المصغّرة. يُرجى الاطلاع على
    [تفاصيل thumbNailOffset.](/apis/post/social-networks/instagram#reels-thumbnails)
  </li>
</ul>

يُرجى الاطلاع على [متطلبات فيديو Reels API](/media-guidelines/instagram#reels) أو [مثال على استخدام Instagram Reels API](https://www.ayrshare.com/blog/instagram-reels-api-how-to-post-videos-to-reels-using-a-social-media-api/).

يمكنك أيضًا تعيين [عنوان URL لغلاف Reels](/apis/post/social-networks/instagram#reels-thumbnails) و[الموقع وعلامات المستخدمين](/apis/post/social-networks/instagram#user-tags-and-locations).

## Reels تجريبية

Reel التجريبي هو Reel يُنشر فقط لغير المتابعين عند نشره لأول مرة، ما يتيح لك اختبار أداء الـ Reel مع جمهور جديد قبل أن يصل إلى متابعيك الحاليين. عيّن `trialParams.graduationStrategy` في `instagramOptions` لنشر Reel كتجربة.

```json Instagram Trial Reel theme={"system"}
{
  "post": "Testing this with a fresh audience first",
  "mediaUrls": ["https://img.ayrshare.com/random/portrait1.mp4"],
  "platforms": ["instagram"],
  "instagramOptions": {
    "trialParams": {
      "graduationStrategy": "MANUAL"
    }
  }
}
```

يتحكّم `graduationStrategy` في كيفية "تخرّج" الـ Reel التجريبي لاحقًا — أي أن يصبح مرئيًا لمتابعيك أيضًا. وهو مطلوب عند توفير `trialParams` ويجب أن يكون أحد:

<ul class="custom-bullets">
  <li>
    <code>"MANUAL"</code> — يبقى المنشور Reel تجريبيًا حتى تقوم يدويًا بترقيته من
    داخل تطبيق Instagram.
  </li>

  <li>
    <code>"SS\_PERFORMANCE"</code> — تقوم Meta بترقية الـ Reel تلقائيًا بناءً على الأداء المبكّر
    مقابل غير المتابعين.
  </li>
</ul>

<Note>
  التخرّج ذاته (ترقية Reel تجريبي منشور إلى المتابعين) غير متاح حاليًا في
  واجهة API الخاصة بـ Meta ويجب تنفيذه يدويًا في تطبيق Instagram. ستضيف Ayrshare نقطة نهاية للتخرّج
  بمجرد إتاحة Meta لها.
</Note>

### قيود Reels التجريبية

يُرفض طلب Reel التجريبي على حافة Ayrshare — قبل أي استدعاء لـ Meta — عندما لا يتمّ الوفاء بأيٍّ من هذه الشروط:

<ul class="custom-bullets">
  <li>عنوان URL واحد بالضبط للوسائط ينتهي بـ <code>.mp4</code> أو <code>.mov</code> (غير حسّاس لحالة الأحرف). الـ carousels غير مدعومة.</li>
  <li>يجب ألا يكون <code>instagramOptions.stories</code> بقيمة <code>true</code>. لا يمكن أن تكون Stories Reels تجريبية.</li>
  <li>يجب أن يكون <code>graduationStrategy</code> موجودًا وأن يساوي تمامًا <code>"MANUAL"</code> أو <code>"SS\_PERFORMANCE"</code> (حسّاس لحالة الأحرف).</li>
</ul>

تُعيد الإخفاقات أحد ثلاثة رموز أخطاء من Ayrshare — راجع [أخطاء Instagram Trial Reel](/errors/errors-ayrshare#instagram-specific-error-codes) (<code>447</code>, <code>448</code>, <code>449</code>) للاطلاع على الحمولات الكاملة.

## Instagram Stories

يمكنك نشر صورة أو فيديو واحد كقصة Instagram Story باستخدام `instagramOptions` التالية. تختفي قصص Instagram بعد 24 ساعة.

```json Stories Post theme={"system"}
{
  "post": "The description of the video",
  "mediaUrls": ["https://img.ayrshare.com/random/portrait1.mp4"],
  "instagramOptions": {
    "stories": true
  }
}
```

يُرجى الاطلاع على [متطلبات Stories API](/media-guidelines/instagram#stories).

<ul class="custom-bullets">
  <li>
    لا تدعم Instagram Stories نص المنشور - أيّ نص مقدّم في حقل `post`، بما في ذلك
    الإشارات، سيتم تجاهله.
  </li>

  <li>تنتهي صلاحية القصص بعد 24 ساعة.</li>

  <li>
    يدعم Instagram حاليًا نشر Story على حسابات Instagram Business فقط وليس على
    حسابات Creator.
  </li>

  <li>لا تدعم Instagram Stories المتعاونين.</li>
  <li>نشر الملصقات (أي رابط أو استطلاع أو موقع) غير مدعوم من قِبل Instagram.</li>
</ul>

## صور Reels المصغّرة

يمكنك اختيار إطار من الـ Reel كصورة مصغّرة أو صورة غلاف خاصة بك (thumbnail) من عنوان URL خارجي.

```json Instagram Thumbnail theme={"system"}
{
  "instagramOptions": {
    // milliseconds
    "thumbNailOffset": 30000,
    // If both thumbNail and thumbNailOffset includes, thumbNail will be used.
    "thumbNail": "https://img.ayrshare.com/012/gb.jpg"
  }
}
```

الإزاحة هي الموقع بالمللي ثانية لإطار الصورة المصغّرة من فيديو Reel. القيمة الافتراضية هي `0`، وهي أول إطار في الـ Reel.

إذا حدّدت كلًا من عنوان URL للصورة المصغّرة وإزاحة الصورة المصغّرة، فسيتم تجاهل إزاحة الصورة المصغّرة.

يجب أن تفي الصورة المصغّرة للـ Reel بـ [متطلبات الصورة المصغّرة لـ Reels](/media-guidelines/instagram#reels-thumbnails).
لا تُضمَن توافقية عناوين URL الموقّعة مع عمليات إعادة التوجيه مع عناوين URL للغلاف.
نوصي بعنوان URL غير موقّع أو استخدام [نقطة النهاية /media](/apis/media/overview).

## النص البديل

أضف نصًا بديلاً لـ Instagram، والمعروف أيضًا بـ alt text، إلى صورة.
النص البديل في Instagram هو ميزة إمكانية وصول تُستخدم لتوفير معلومات إضافية للمستخدمين وقارئات الشاشة.

<ul class="custom-bullets">
  <li>يدعم النص البديل حتى 1,000 حرف لكل صورة.</li>
  <li>لا يدعم Instagram النص البديل لـ Reels أو Stories.</li>
</ul>

استخدم `altText` في كائن `instagramOptions`.

```json Instagram Alt Text theme={"system"}
{
  "instagramOptions": {
    // Array of Alt Texts
    "altText": ["This is my best pic", "😃 here is the next one"]
  }
}
```

يجب أن يقابل كل نص بديل صورة أو فيديو في مصفوفة `mediaUrls`.
سيُطبَّق النص البديل على كل صورة بالترتيب.

## علامات المستخدم والمواقع

<Info>
  سيُشعَر مستخدم Instagram عند استخدام اسم مستخدمه في منشور. يُرجى الحرص على
  عدم إزعاج المستخدمين أو النشر باستخدام اسم مستخدمهم بشكل متكرّر. إذا فعلت ذلك، فقد يعلّق Instagram حسابك
  أو يعطّله.
</Info>

يمكن وضع علامة على صورة أو Reel بمستخدمي Instagram، ويمكن وضع علامة على صورة أو فيديو أو Reel بموقع باستخدام معلمة `instagramOptions`.

### الموقع

يتم تحديد الموقع بواسطة `locationId`، وهو معرّف Facebook Page ID أو اسم Facebook Page. على سبيل المثال، معرّف صفحة Facebook لـ [متحف Guggenheim](https://www.facebook.com/guggenheimmuseum) هو `7640348500` أو اسم صفحة Facebook `"@guggenheimmuseum"`. يجب أن تكون الصفحات مرتبطة بموقع فعلي.

```json Instagram Location theme={"system"}
// Using the Facebook Page Id - must be associated with a location
{
    "instagramOptions": {
        "locationId": 7640348500 // Guggenheim Museum Page Id
    }
}

// Using the Facebook Page name - must be associated with a location
{
    "instagramOptions": {
        "locationId": "@guggenheimmuseum" // Guggenheim Museum Page name. Must begin with @
    }
}
```

يمكنك البحث عن `locationId` (Page Id) عبر [نقطة نهاية brand](/apis/brand/overview). يُرجى ملاحظة أن الصفحة يجب أن يكون لديها موقع مدرَج وإلا سيُعيد locationId خطأً.

<Note>غير مدعوم على الصور أو الفيديوهات في الـ carousels.</Note>

### علامات المستخدم

تتيح لك علامات Instagram وضع علامات على مستخدمي Instagram الآخرين في منشورك.
يتم تحديد المستخدمين بواسطة `userTags` تحتوي على مصفوفة من الكائنات باسم مستخدم Instagram وإحداثيات x/y (للصور فقط). يمكن إضافة علامات المستخدمين للصور المفردة أو Reels، لكن ليس للفيديوهات العادية أو الصور المتعدّدة أو Stories.

<ul class="custom-bullets">
  <li>يجب أن تكون أسماء المستخدمين حسابات Instagram عامة. لا تُضمِّن @ في مقبض المستخدم.</li>

  <li>
    يجب أن تكون قيم `x` و `y` أرقام `float` تنشأ من الزاوية العلوية اليسرى للصورة، بـ
    نطاق `0.0`–`1.0`. للصور المفردة. لا تُضمِّنها مع Reels وإلا سيحدث خطأ.
  </li>
</ul>

```json Instagram User Tags theme={"system"}
{
  "instagramOptions": {
    "userTags": [
      {
        "username": "ayrshare", // Required: Instagram username
        "x": 0.5, // Required for Images, cannot be used with Reels
        "y": 1.0 // Required for Images, cannot be used with Reels
      },
      {
        "username": "johnboy", // Required: Instagram username
        "x": 0.1, // Required for Images, cannot be used with Reels
        "y": 0.9 // Required for Images, cannot be used with Reels
      }
    ]
  }
}
```

## إشارات Instagram

اذكر مقبض Instagram آخر بإضافة @handle في نص المنشور.

على سبيل المثال يمكنك ذكر مقبض @ayrshare في نص المنشور:

```json Instagram Mentions theme={"system"}
{
  "post": "The best social media API @Ayrshare ever!", // empty string is allowed
  "mediaUrls": ["https://images.com/image.jpg"],
  "platforms": ["instagram"]
}
```

<Warning>
  سيتمّ إبلاغ المستخدم `@mentioned` بالإشارة. يُرجى مراجعة [القواعد
  المهمّة](/testing/post-verification#mentions) بشأن الإشارات.
</Warning>

## التعاون

يتيح لك تعاون Instagram المشاركة في تأليف المحتوى مع حسابات Instagram الأخرى عبر [وضع علامات على الآخرين كمتعاونين](https://www.facebook.com/help/instagram/291200585956732).
يتيح لك ذلك تعيين مستخدمي Instagram الآخرين كصنّاع محتوى في منشورك.
عند وضع علامة، يتلقّى هؤلاء المستخدمون دعوة للتعاون في تطبيق الجوّال.
إذا قبلوا، فسيظهر المنشور أيضًا في خلاصتهم وسيكون مرئيًا لمتابعيهم، مما يوسّع من مدى وصول المنشور وإمكانات التفاعل.

### المتعاونون

يمكن للمؤلف الأصلي العام وضع علامة على حساب عام آخر كمتعاون في Instagram.
سيتلقّى الحساب الآخر رسالة، تسمح له إمّا بقبول الطلب أو رفضه.
إذا قبل الحساب الآخر، فسيظهر المنشور أيضًا في ملفه الشخصي وسيتم توزيعه على متابعيه في خلاصة Instagram.
سيُنسب رأس المنشور المحتوى إلى كلا الحسابين.

يمكنك إضافة متعاونين إلى Reel أو صورة أو carousel.

لا يُسمح بوضع علامة على متعاون خاص عبر Instagram API. على الرغم من
وجود هذه الوظيفة داخل تطبيق Instagram، إلّا أن المنصّات وواجهات API الخاصة بها
غالبًا لا تكون بنفس [المستوى من الميزات](/help-center/product/are_social_networks_native_apps_and_the_apis_at_parity).

<Warning>لا تدعم Instagram Stories المتعاونين.</Warning>

<Warning>
  <ul class="custom-bullets">
    <li>**ادعُ فقط المتعاونين الذين تتوقّع منهم `قبول` دعوتك**.</li>

    <li>
      إذا [ردّ المتعاون](/apis/post/social-networks/instagram#get-collaborator-request-status) بطلب تعاون
      `declined`، فـ **لا تدعوه مجدّدًا** حتى تتواصل معه
      لفهم سبب الرفض.
    </li>

    <li>
      الرفض المتكرّر من نفس المستخدمين أو من عدّة مستخدمين سيعرّض حسابيك على Instagram وAyrshare
      لخطر الإلغاء.
    </li>

    <li>يمكن للمؤلف الأصلي إضافة أو إزالة متعاون في أي وقت.</li>
  </ul>
</Warning>

ادعُ *حتى ثلاثة* متعاونين بمصفوفة أسماء مستخدمي Instagram عامة.

```json Instagram Collaborators theme={"system"}
{
  "instagramOptions": {
    "collaborators": ["ayrshare", "therock", "taylorswift"] // Up to three
  }
}
```

سيتلقّى هؤلاء المتعاونون الثلاثة رسالة دعوة في تطبيق Instagram للجوّال ويمكنهم قبول أو رفض الدعوة، ثم يمكنك [التحقق من حالة طلب المستخدم المدعو](/apis/post/social-networks/instagram#get-collaborator-request-status).
يُرجى دعوة المتعاونين الذين تعلم أنهم سيقبلون طلبك فقط أو قد يتأثّر حساب Instagram الخاص بك سلبًا.

<Warning>
  ملاحظة حول المتعاونين المدعوّين: مع بعض الاستثناءات، لا يمكن الوصول إلى بيانات الوسائط المؤلَّفة بشكل مشترك أو حولها
  عبر API إلّا من قِبل المستخدم الذي نشر الوسائط؛ لا يستطيع المتعاونون
  الوصول إلى هذه البيانات عبر API.
</Warning>

### الحصول على حالة طلب المتعاون

بعد دعوة متعاون Instagram، يمكنك التحقق من حالة الطلب باستخدام [Get Collaborator Request Status API](/apis/utils/instagram-get-collaborator).

## تغيير حجم الصورة تلقائيًا

<Note>Max Pack مطلوب</Note>

يتم تغيير حجم الصور تلقائيًا إلى 1080 x 1080 بكسل للعمل مع Instagram باستخدام معلمة `autoResize`. يُرجى ملاحظة أن هذا سيغيّر حجم الصورة لجميع المنصّات المُضمَّنة، لذا نوصي بإجراء استدعاء واحد لـ Instagram واستدعاء /post مختلف للمنصّات الإضافية.

```json Instagram Auto Image Resize theme={"system"}
{
  "post": "Let it go!",
  "platforms": ["instagram"],
  "mediaUrls": ["https://images.ayrshare.com/imgs/GhostBusters.jpg"],
  "instagramOptions": {
    "autoResize": true, // Max Pack
    "locationId": 7640348500,
    "userTags": [
      {
        "username": "ayrshare",
        "x": 0.5,
        "y": 0.5
      },
      {
        "username": "ayrshare",
        "x": 0.3,
        "y": 0.2
      }
    ]
  }
}
```

## الحصّة المستخدمة

ستتضمّن استجابة Instagram الـ `usedQuota` الحالي لعدد منشورات Instagram المُنفَّذة خلال فترة 24 ساعة متجدّدة. يسمح Instagram فقط بـ 50 منشور Instagram في فترة 24 ساعة متجدّدة.

```json Instagram Used Quota theme={"system"}
{
    "status": "success",
    "errors": [],
    "postIds": [
        {
            "status": "success",
            "id": "17823977408036085",
            "postUrl": "https://www.instagram.com/p/CeBrkQuN1Kv/",
            "usedQuota": 15,
            "platform": "instagram"
        }
    ],
    "id": "l4FaPHSXWJNdmMfm3dIE",
    "refId": "65806e8d9efd78a58c05566a887043329dcdc76b",
    "post": "Luckily for Alice, the little magic bottle had now had its full effect."
}
```

إذا تمّ الوصول إلى الحصّة، فستُعاد رسالة خطأ.

## مشاكل المحتوى

تتضمّن Ayrshare حماية وسائط مدمجة يمكنها اكتشاف بعض مشاكل تسليم الوسائط وحلّها أثناء النشر. عندما ينجح المنشور ولكن تمّ اكتشاف مشكلة محتوى وحلّها، تتضمّن الاستجابة كائنًا اختياريًا `contentIssues`. يتيح لك ذلك تحديد مشكلات استضافة الوسائط وإصلاحها بشكل استباقي.

يكون كائن `contentIssues` موجودًا فقط عند اكتشاف مشكلة وحلّها — لا تتضمّنه المنشورات الناجحة العادية.

| الحقل                   | النوع             | الوصف                                                                                                                                                                                                                                                                                                                 |
| ----------------------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `originMediaHostFailed` | boolean           | لم تتمكّن الشبكة الاجتماعية من استرداد الوسائط من عنوان URL المُقدَّم. حلّت حماية الوسائط الآلية لـ Ayrshare المشكلة وأكملت المنشور بنجاح. فكِّر في مراجعة تكوين استضافة الوسائط الخاص بك — راجع [Meta Media Crawler Blocked](/help-center/technical-support/meta_media_crawler_blocked) للاطلاع على الأسباب الشائعة. |
| `details`               | مصفوفة من السلاسل | أوصاف مقروءة بشريًا لكل مشكلة تمّ اكتشافها.                                                                                                                                                                                                                                                                           |

```json Content Issues Response Example theme={"system"}
{
    "status": "success",
    "errors": [],
    "postIds": [
        {
            "status": "success",
            "id": "17878176260289172",
            "postUrl": "https://www.instagram.com/p/CP1dI9Hp_WO/",
            "usedQuota": 12,
            "platform": "instagram",
            "contentIssues": {
                "originMediaHostFailed": true,
                "details": [
                    "Media URL could not be retrieved by the social network. Successfully posted using Ayrshare automated media protection."
                ]
            }
        }
    ],
    "id": "abc123",
    "refId": "65806e8d9efd78a58c05566a887043329dcdc76b",
    "post": "Your post text here"
}
```

<Tip>
  إذا رأيت `originMediaHostFailed` في استجاباتك، فقد تكون هناك مشكلة في استضافة الوسائط الخاصة بك تمنع الشبكات الاجتماعية من الوصول إلى وسائطك. راجع [Meta Media Crawler Blocked](/help-center/technical-support/meta_media_crawler_blocked) للاطلاع على خطوات استكشاف الأخطاء وإصلاحها المفصّلة.
</Tip>

## تفاصيل الخطأ

<Info>
  عندما يفشل نشر وسائط Instagram، يعرض كائن الخطأ الآن نصّ الخطأ الأساسي من Meta في حقل `details`، إلى جانب `code` و`message` الخاصَّين بـ Ayrshare. يتيح لك ذلك التمييز بين الأسباب الجذرية المختلفة (على سبيل المثال، رفض نسبة العرض إلى الارتفاع مقابل فشل تنزيل الوسائط) دون الحاجة إلى الاتصال بالدعم.
</Info>

```json Instagram Publish Error theme={"system"}
{
    "status": "error",
    "errors": [
        {
            "action": "post",
            "status": "error",
            "platform": "instagram",
            "code": 156,
            "message": "An error occurred while posting to Instagram.",
            "details": "The submitted image was not found. The aspect ratio is not supported. Please see https://developers.facebook.com/docs/instagram-api for more information."
        }
    ]
}
```

`message` هو ملخّص Ayrshare المستقرّ والمقروء بشريًا، بينما يعكس `details` النص الخام الذي أعادته Meta للنشر الفاشل.

## إضافة فواصل أسطر أو نص منسّق إلى منشور Instagram

يمكن إضافة فواصل أسطر Instagram إلى منشور بحرف [سطر جديد خاص](/apis/post/post#line-breaks).

يمكن إضافة نص منسّق، مثل الأحرف الغامقة أو المائلة، إلى منشور Instagram ببضعة [عناصر html](/apis/post/overview#rich-text-posts).

## حدود الأحرف

يُرجى الاطلاع على [حدود أحرف Instagram](/help-center/technical-support/character_limits#instagram-character-limits) لمزيد من المعلومات.

## نقاط نهاية إضافية

<Card title="الحصول على حالة طلب المتعاون" icon="code" href="/apis/utils/instagram-get-collaborator" horizontal />