> ## 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

> Các tùy chọn để đăng bài bằng Instagram API

<Info>
  Nếu bạn gặp vấn đề khi kết nối Instagram, vui lòng xem [hướng dẫn khắc phục
  sự cố](/help-center/technical-support/facebook_or_instagram_linking_issues).
</Info>

<Info>
  Nếu phương tiện của bạn được lưu trữ trên máy chủ hoặc CDN mà bạn kiểm soát, hãy đảm bảo trình thu thập dữ liệu
  xuất bản của Meta có thể lấy được nó. Xem [Meta Media Crawler Blocked](/help-center/technical-support/meta_media_crawler_blocked)
  nếu bạn thấy mã lỗi Ayrshare 440 ("social network could not download media from this URL") hoặc mã lỗi 138 với "Restricted by robots.txt" trong chi tiết.
</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 có các yêu cầu và hạn chế sau.

<ul class="custom-bullets">
  <li>
    Tài khoản Instagram Business hoặc Creator được kết nối với một Facebook Page - [xem
    tại đây](/dashboard/connect-social-accounts/instagram).
  </li>

  <li>Chỉ được phép 50 bài đăng Instagram trong khoảng thời gian 24 giờ. Xem bên dưới về `usedQuota`</li>

  <li>
    Nội dung `post` có thể chứa tối đa *5 hashtag* (ví dụ #wildtimes) và *3 mention username*
    (ví dụ @natgeo).
  </li>

  <li>@mention người dùng Instagram sẽ nhận được thông báo.</li>
  <li>Tối đa 2.200 ký tự cho bài đăng.</li>

  <li>
    Bài đăng nhiều hình ảnh/video được hỗ trợ và được gửi dưới dạng carousel. Bạn có thể gửi tối đa 10 video và
    hình ảnh.
  </li>

  <li>
    Instagram không hỗ trợ xóa qua API. Việc xóa phải được thực hiện thủ công bằng ứng dụng Instagram.
  </li>

  <li>
    Nếu video Reel của bạn không kết thúc bằng phần mở rộng video đã biết như mp4, vui lòng sử dụng tham số `isVideo`.
    Xem [endpoint /post](/apis/post/post) để biết chi tiết.
  </li>

  <li>
    Instagram cũng hỗ trợ gửi phương tiện mà không có nội dung bài đăng. Nếu bạn không muốn bao gồm nội dung bài đăng,
    hãy gửi một chuỗi rỗng `post: ""`.
  </li>

  <li>Xem [Instagram Media Guidelines](/media-guidelines/instagram) và [Instagram Authorization](/dashboard/connect-social-accounts/instagram) để biết thêm thông tin.</li>
</ul>

## Đăng bài lên Instagram

JSON cho một bài đăng cơ bản với hình ảnh và hashtag lên 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"]
}
```

Hashtag có thể nhấp trong bài đăng Instagram, nhưng liên kết thì không.

<Note>
  Tỷ lệ khung hình của hình ảnh & video và thời lượng video rất quan trọng để đăng bài thành công lên Instagram. Nếu chúng không đáp ứng các yêu cầu, bài đăng sẽ bị từ chối.

  [Vui lòng xem phần Instagram của Hướng dẫn hình ảnh và video](/media-guidelines/instagram).
</Note>

## Tài khoản Instagram Business hoặc Creator

Tài khoản Instagram của bạn phải là Tài khoản Business hoặc Creator và được kết nối với một Facebook Page. Việc thiết lập miễn phí và dễ dàng.

Xem tại đây để biết hướng dẫn chi tiết:

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

## Carousel hình ảnh và video

Bạn có thể đăng nhiều hình ảnh hoặc video Reel lên Instagram dưới dạng carousel; tối đa tổng cộng 10 hình ảnh hoặc video có thể được dùng trong một carousel.
Chỉ cần thêm hình ảnh hoặc video bổ sung của bạn vào mảng `mediaUrls`, và carousel sẽ được tạo tự động.

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

<Note>
  URL video phải kết thúc bằng phần mở rộng đã biết như `mp4`. Tham số `isVideo` không được hỗ trợ
  cho carousel Instagram.
</Note>

## Instagram Reels

Trong Instagram, một bài đăng video được gọi là Reel.
Bạn có thể đăng một video lên Instagram Reels API với các tùy chọn `instagramOptions` tùy chọn sau.

```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>
    Vui lòng xem [yêu cầu video Reels API](/media-guidelines/instagram#reels) để biết chi tiết về
    các yêu cầu video.
  </li>

  <li>
    `shareReelsFeed`: Boolean đặt thành `true` để chỉ ra rằng Reel *có thể* xuất hiện ở cả
    tab **Feed** và **Reels** hoặc `false` để chỉ ra Reel *chỉ có thể* xuất hiện ở tab **Reels**.
    Giá trị này là gợi ý cho Instagram nơi bạn muốn Reel xuất hiện, nhưng không giá trị nào
    quyết định liệu Reel *thực sự* xuất hiện ở tab **Reels** hoặc **Feed** hay không vì
    Reel có thể không đáp ứng các yêu cầu đủ điều kiện hoặc có thể không được thuật toán của Instagram chọn.
  </li>

  <li>
    `audioName`: Tên chuỗi của nhạc audio của phương tiện Reels. Bạn chỉ có thể đổi tên một lần, hoặc là
    trong khi tạo reel hoặc sau khi tạo từ trang audio. Ví dụ, `"The Weeknd - Blinding
            Lights"`.
  </li>

  <li>
    `thumbNail`: URL chuỗi của hình ảnh bìa Reel (thumbnail). Vui lòng xem tại đây để biết [chi tiết về
    thumbNail](/apis/post/social-networks/instagram#reels-thumbnails).
  </li>

  <li>
    `thumbNailOffset`: Offset integer tính bằng mili giây của khung thumbnail. Vui lòng xem tại đây để biết
    [chi tiết về thumbNailOffset.](/apis/post/social-networks/instagram#reels-thumbnails)
  </li>
</ul>

Vui lòng xem [yêu cầu video Reels API](/media-guidelines/instagram#reels) hoặc [ví dụ về việc sử dụng Instagram Reels API](https://www.ayrshare.com/blog/instagram-reels-api-how-to-post-videos-to-reels-using-a-social-media-api/).

Bạn cũng có thể đặt [Reels cover url](/apis/post/social-networks/instagram#reels-thumbnails) và [thẻ vị trí & người dùng](/apis/post/social-networks/instagram#user-tags-and-locations).

## Trial Reels

Trial reel là một Reel chỉ được xuất bản cho những người không theo dõi khi mới đăng, cho phép bạn kiểm tra Reel hoạt động như thế nào với một đối tượng mới trước khi nó tiếp cận những người theo dõi hiện có của bạn. Đặt `trialParams.graduationStrategy` trong `instagramOptions` để xuất bản một Reel dưới dạng trial.

```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` kiểm soát cách một trial reel sau này "graduates" — tức là trở nên hiển thị với cả những người theo dõi của bạn. Nó bắt buộc khi `trialParams` được cung cấp và phải là một trong:

<ul class="custom-bullets">
  <li>
    <code>"MANUAL"</code> — bài đăng vẫn là trial reel cho đến khi bạn tự tay graduate nó từ
    bên trong ứng dụng Instagram.
  </li>

  <li>
    <code>"SS\_PERFORMANCE"</code> — Meta tự động graduate Reel dựa trên hiệu suất ban đầu
    đối với những người không theo dõi.
  </li>
</ul>

<Note>
  Bản thân việc graduation (thăng cấp một trial reel đã xuất bản lên những người theo dõi) hiện không được Meta
  cung cấp qua API và phải được thực hiện thủ công trong ứng dụng Instagram. Ayrshare sẽ thêm một endpoint
  graduation khi Meta cung cấp một endpoint.
</Note>

### Hạn chế Trial reel

Yêu cầu trial reel bị từ chối ở edge của Ayrshare — trước bất kỳ cuộc gọi Meta nào — khi bất kỳ điều kiện nào sau đây không được đáp ứng:

<ul class="custom-bullets">
  <li>Chính xác một URL phương tiện kết thúc bằng <code>.mp4</code> hoặc <code>.mov</code> (không phân biệt chữ hoa/thường). Carousels không được hỗ trợ.</li>
  <li><code>instagramOptions.stories</code> không được là <code>true</code>. Stories không thể là trial reels.</li>
  <li><code>graduationStrategy</code> phải có mặt và chính xác là <code>"MANUAL"</code> hoặc <code>"SS\_PERFORMANCE"</code> (phân biệt chữ hoa/thường).</li>
</ul>

Các lỗi trả về một trong ba mã lỗi Ayrshare — xem [Lỗi Instagram Trial Reel](/errors/errors-ayrshare#instagram-specific-error-codes) (<code>447</code>, <code>448</code>, <code>449</code>) để biết payload đầy đủ.

## Instagram Stories

Bạn có thể đăng một hình ảnh hoặc video đơn lẻ dưới dạng Instagram Story với `instagramOptions` sau. Instagram stories biến mất sau 24 giờ.

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

Vui lòng xem [yêu cầu Stories API](/media-guidelines/instagram#stories).

<ul class="custom-bullets">
  <li>
    Instagram Stories không hỗ trợ nội dung bài đăng — bất kỳ văn bản nào được cung cấp trong trường `post`, bao gồm cả
    mentions, sẽ bị bỏ qua.
  </li>

  <li>Stories hết hạn sau 24 giờ.</li>

  <li>
    Instagram hiện chỉ hỗ trợ xuất bản Story trên các tài khoản Instagram Business và không
    hỗ trợ tài khoản Creator.
  </li>

  <li>Instagram Stories không hỗ trợ cộng tác viên.</li>
  <li>Xuất bản stickers (tức là, link, poll, location) không được Instagram hỗ trợ.</li>
</ul>

## Thumbnail Reels

Bạn có thể chọn một khung của Reel làm hình ảnh thumbnail hoặc hình ảnh bìa của riêng bạn (thumbnail) từ URL bên ngoài.

```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"
  }
}
```

Offset là vị trí tính bằng mili giây của khung thumbnail của video Reel. Giá trị mặc định là `0`, là khung đầu tiên của Reel.

Nếu bạn chỉ định cả URL thumbnail và thumbnail offset, thumbnail offset sẽ bị bỏ qua.

Thumbnail Reel phải tuân theo [yêu cầu thumbnail Reels](/media-guidelines/instagram#reels-thumbnails).
Các URL đã ký với chuyển hướng không được đảm bảo tương thích với URL bìa.
Chúng tôi khuyến nghị URL không có chữ ký hoặc sử dụng [endpoint /media](/apis/media/overview).

## Văn bản thay thế (Alt Text)

Thêm văn bản thay thế Instagram, còn được gọi là alt text, vào một hình ảnh.
Alt text Instagram là một tính năng trợ năng được sử dụng cho thông tin bổ sung của người dùng và trình đọc màn hình.

<ul class="custom-bullets">
  <li>Alt text hỗ trợ tối đa 1.000 ký tự cho mỗi hình ảnh.</li>
  <li>Instagram không hỗ trợ alt text cho Reels hoặc Stories.</li>
</ul>

Sử dụng `altText` trong đối tượng `instagramOptions`.

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

Mỗi alt text phải tương ứng với một hình ảnh hoặc video trong mảng `mediaUrls`.
Alt text sẽ được áp dụng cho từng hình ảnh theo thứ tự.

## Thẻ người dùng & Vị trí

<Info>
  Người dùng Instagram sẽ được thông báo khi bạn sử dụng username của họ trong một bài đăng. Vui lòng cẩn thận
  không spam người dùng hoặc đăng bài với username của họ nhiều lần. Nếu bạn làm như vậy, Instagram có thể tạm ngưng hoặc
  vô hiệu hóa tài khoản của bạn.
</Info>

Một hình ảnh hoặc Reel có thể được gắn thẻ với người dùng Instagram và một hình ảnh, video, hoặc Reel có thể được gắn thẻ vị trí bằng tham số `instagramOptions`.

### Vị trí

Một vị trí được chỉ định bằng `locationId`, là Facebook Page ID hoặc tên Facebook Page. Ví dụ, Facebook page Id của [Guggenheim Museum](https://www.facebook.com/guggenheimmuseum) là `7640348500` hoặc tên Facebook page `"@guggenheimmuseum"`. Các trang phải được liên kết với một vị trí thực.

```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 @
    }
}
```

Bạn có thể tra cứu `locationId` (Page Id) với [endpoint brand](/apis/brand/overview). Xin lưu ý rằng Page phải có vị trí được liệt kê hoặc locationId sẽ trả về lỗi.

<Note>Không được hỗ trợ trên hình ảnh hoặc video trong carousel.</Note>

### Thẻ người dùng

Các thẻ Instagram cho phép bạn gắn thẻ những người dùng Instagram khác trong bài đăng của bạn.
Người dùng được chỉ định bởi `userTags` chứa Mảng các đối tượng với username Instagram và tọa độ x/y (chỉ hình ảnh). Thẻ người dùng có thể được thêm cho các hình ảnh đơn lẻ hoặc Reels, nhưng không cho các video thông thường, nhiều hình ảnh, hoặc Stories.

<ul class="custom-bullets">
  <li>Username phải là các tài khoản Instagram công khai. Không bao gồm @ của user handle.</li>

  <li>
    Giá trị `x` và `y` phải là số `float` bắt nguồn từ góc trên bên trái của hình ảnh, với
    phạm vi `0.0`–`1.0`. Hình ảnh đơn lẻ. Không bao gồm với Reels hoặc sẽ xảy ra lỗi.
  </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
      }
    ]
  }
}
```

## Nhắc tên (Mention) trên Instagram

Nhắc tên một handle Instagram khác bằng cách thêm @handle vào nội dung bài đăng.

Ví dụ bạn có thể nhắc tên handle @ayrshare trong nội dung bài đăng:

```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>
  Người dùng `@mentioned` sẽ được thông báo về việc nhắc tên. Vui lòng xem lại [các quy tắc
  quan trọng](/testing/post-verification#mentions) về nhắc tên.
</Warning>

## Cộng tác

Cộng tác Instagram cho phép bạn đồng sáng tác nội dung với các tài khoản Instagram khác bằng cách [gắn thẻ những người khác làm cộng tác viên](https://www.facebook.com/help/instagram/291200585956732).
Điều này cho phép bạn chỉ định những người dùng Instagram khác làm người tạo trên bài đăng của bạn.
Khi được gắn thẻ, những người dùng này nhận được lời mời cộng tác trong ứng dụng di động.
Nếu họ chấp nhận, bài đăng cũng sẽ xuất hiện trong feed của họ và hiển thị với những người theo dõi của họ, mở rộng phạm vi tiếp cận và tiềm năng tương tác của bài đăng.

### Cộng tác viên

Tác giả gốc công khai có thể gắn thẻ một tài khoản công khai khác làm cộng tác viên Instagram.
Tài khoản khác sẽ nhận được một tin nhắn, cho phép họ chấp nhận hoặc từ chối yêu cầu.
Nếu tài khoản khác chấp nhận, bài đăng cũng sẽ hiển thị trên profile của họ và được phân phối đến những người theo dõi của họ trong feed Instagram.
Header của bài đăng sẽ ghi nhận nội dung cho cả hai tài khoản.

Bạn có thể thêm cộng tác viên vào một Reel, hình ảnh, hoặc carousel.

Việc gắn thẻ một cộng tác viên riêng tư không được phép qua Instagram API. Trong khi
chức năng này tồn tại trong ứng dụng Instagram, các nền tảng và API của chúng
thường không ở [feature parity](/help-center/product/are_social_networks_native_apps_and_the_apis_at_parity).

<Warning>Instagram Stories không hỗ trợ cộng tác viên.</Warning>

<Warning>
  <ul class="custom-bullets">
    <li>**Chỉ mời cộng tác viên mà bạn mong đợi sẽ `accept` lời mời của bạn**.</li>

    <li>
      Nếu [cộng tác viên
      phản hồi](/apis/post/social-networks/instagram#get-collaborator-request-status) với một
      yêu cầu cộng tác `declined`, **đừng mời lại họ** cho đến khi bạn liên hệ với họ để
      hiểu lý do từ chối.
    </li>

    <li>
      Việc bị từ chối lặp lại từ cùng một hoặc nhiều người dùng sẽ đặt tài khoản Instagram và Ayrshare
      của bạn vào rủi ro bị hủy.
    </li>

    <li>Tác giả gốc có thể thêm hoặc xóa một cộng tác viên bất cứ lúc nào.</li>
  </ul>
</Warning>

Mời *tối đa ba* cộng tác viên bằng một mảng username Instagram công khai.

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

Ba cộng tác viên này sẽ nhận được lời mời tin nhắn trong ứng dụng Instagram di động của họ và có thể chấp nhận hoặc từ chối lời mời, và sau đó bạn có thể [kiểm tra trạng thái yêu cầu của người dùng được mời](/apis/post/social-networks/instagram#get-collaborator-request-status).
Vui lòng chỉ mời cộng tác viên mà bạn biết sẽ chấp nhận yêu cầu của bạn hoặc tài khoản Instagram của bạn có thể bị ảnh hưởng tiêu cực.

<Warning>
  Lưu ý về cộng tác viên được mời: Với một vài ngoại lệ, dữ liệu trên hoặc về phương tiện đồng sáng tác chỉ
  có thể được truy cập qua API bởi người dùng đã xuất bản phương tiện; các cộng tác viên không thể
  truy cập dữ liệu này qua API.
</Warning>

### Lấy trạng thái yêu cầu cộng tác viên

Sau khi mời một cộng tác viên Instagram, bạn có thể kiểm tra trạng thái yêu cầu bằng [API Get Collaborator Request Status](/apis/utils/instagram-get-collaborator).

## Tự động thay đổi kích thước hình ảnh

<Note>Yêu cầu Max Pack</Note>

Hình ảnh được tự động thay đổi kích thước thành 1080 x 1080 px để hoạt động với Instagram bằng tham số `autoResize`. Xin lưu ý, điều này sẽ thay đổi kích thước hình ảnh cho tất cả các nền tảng được bao gồm, vì vậy chúng tôi khuyến nghị thực hiện một lệnh gọi cho Instagram và một lệnh gọi /post khác cho các nền tảng bổ sung.

```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
      }
    ]
  }
}
```

## Hạn mức đã sử dụng

Phản hồi Instagram sẽ bao gồm `usedQuota` hiện tại cho số lượng bài đăng Instagram đã thực hiện trong khoảng thời gian 24 giờ cuộn. Chỉ 50 bài đăng Instagram được Instagram cho phép trong khoảng thời gian 24 giờ cuộn.

```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."
}
```

Nếu đã đạt đến hạn mức, một thông báo lỗi sẽ được trả về.

## Vấn đề nội dung

Ayrshare bao gồm tính năng bảo vệ phương tiện tích hợp có thể phát hiện và giải quyết một số vấn đề giao nhận phương tiện trong quá trình đăng bài. Khi một bài đăng thành công nhưng đã phát hiện và giải quyết được một vấn đề nội dung, phản hồi bao gồm một đối tượng `contentIssues` tùy chọn. Điều này cho phép bạn xác định và khắc phục các vấn đề với việc lưu trữ phương tiện của mình một cách chủ động.

Đối tượng `contentIssues` chỉ có mặt khi một vấn đề đã được phát hiện và giải quyết — các bài đăng thành công thông thường không bao gồm nó.

| Trường                  | Loại             | Mô tả                                                                                                                                                                                                                                                                                                                                                       |
| ----------------------- | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `originMediaHostFailed` | boolean          | Mạng xã hội không thể lấy phương tiện từ URL được cung cấp. Tính năng bảo vệ phương tiện tự động của Ayrshare đã giải quyết vấn đề và hoàn thành bài đăng thành công. Cân nhắc xem lại cấu hình lưu trữ phương tiện của bạn — xem [Meta Media Crawler Blocked](/help-center/technical-support/meta_media_crawler_blocked) để biết các nguyên nhân phổ biến. |
| `details`               | array of strings | Các mô tả có thể đọc được của con người về từng vấn đề được phát hiện.                                                                                                                                                                                                                                                                                      |

```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>
  Nếu bạn thấy `originMediaHostFailed` trong phản hồi của mình, có thể có vấn đề với việc lưu trữ phương tiện của bạn ngăn các mạng xã hội truy cập vào phương tiện của bạn. Xem [Meta Media Crawler Blocked](/help-center/technical-support/meta_media_crawler_blocked) để biết các bước khắc phục sự cố chi tiết.
</Tip>

## Chi tiết lỗi

<Info>
  Khi việc xuất bản phương tiện Instagram thất bại, đối tượng lỗi hiện làm nổi bật văn bản lỗi cơ bản của Meta trong trường `details`, cùng với `code` và `message` của Ayrshare. Điều này cho phép bạn phân biệt giữa các nguyên nhân gốc khác nhau (ví dụ, từ chối tỷ lệ khung hình so với lỗi tải xuống phương tiện) mà không cần liên hệ hỗ trợ.
</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` là tóm tắt ổn định, có thể đọc được của Ayrshare, trong khi `details` phản chiếu văn bản thô được Meta trả về cho việc xuất bản thất bại.

## Thêm ngắt dòng hoặc văn bản phong phú vào bài đăng Instagram

Ngắt dòng Instagram có thể được thêm vào một bài đăng với [ký tự dòng mới](/apis/post/post#line-breaks) đặc biệt.

Văn bản phong phú, chẳng hạn như chữ đậm hoặc nghiêng, có thể được thêm vào bài đăng Instagram với một vài [phần tử html](/apis/post/overview#rich-text-posts).

## Giới hạn ký tự

Vui lòng xem [Giới hạn ký tự Instagram](/help-center/technical-support/character_limits#instagram-character-limits) để biết thêm thông tin.

## Endpoint bổ sung

<Card title="Get Collaborator Request Status" icon="code" href="/apis/utils/instagram-get-collaborator" horizontal />