---
title: "Instagram: posztolási szabályok és beállítások | Posty dokumentáció"
description: "Mit fogad el a Instagram csatorna a Postyban: média, korlátok, kötelező mezők, és a settings objektum mezői az API-hoz."
canonical: https://posty.hu/dokumentacio/platformok/instagram
source: https://posty.hu/dokumentacio/platformok/instagram.md
---

Platformok

# Instagram: posztolási szabályok és beállítások

Mit fogad el a Instagram csatorna a Postyban: média, korlátok, kötelező mezők, és a settings objektum mezői az API-hoz.

## Alapadatok

Platform

Instagram

Karakterkorlát

A platform nem ad meg általános korlátot.

Média

Kötelező: legalább egy kép vagy videó. Több kép esetén körkép lesz belőle.

settings.\_\_type

`instagram`, `instagram-standalone`

Kötelező mezők

post\_type

A platform oldala

[Instagram ütemező](https://posty.hu/csatornak/instagram)

## Bejegyzéstípusok

Ugyanaz a csatorna többféle alakú bejegyzést fogad el, és mindegyik mást követel meg. A táblázatból kiderül, melyikhez mi kell.

| Típus | Média | Megjegyzés |
| --- | --- | --- |
| Hírfolyam, egy kép | 1 kép, kötelező | post\_type: post. |
| Hírfolyam, körkép | 2 vagy több kép | A több kép automatikusan lapozható körkép lesz. |
| Reels | 1 videó | post\_type: post, videóval. Az Instagram dönti el, hogy Reelsként jelenik meg. |
| Story | 1 kép vagy videó | post\_type: story. Csak egy elem mehet. |

## Szabályok

- Kétféle bekötés van. Az „instagram” a Facebook-oldalhoz kapcsolt üzleti fiók, az „instagram-standalone” a közvetlenül bekötött fiók. A beállítások mezői ugyanazok.
- Story csak akkor mehet ki, ha a fiók erre jogosult a platformon.

## Beállításmezők

Ezek a mezők a bejegyzés `settings` objektumába kerülnek, a `__type` mező mellé. A felületen ugyanezeket a csatorna lenyíló beállításszakaszában töltöd ki.

| Mező | Típus | Kötelező | Mit csinál |
| --- | --- | --- | --- |
| post\_type | "post" \| "story" | igen | Hírfolyam-bejegyzés vagy story. |
| collaborators | tömb, elemenként { label: string } | nem | Együttműködő fiókok felhasználóneve. |
| audio | objektum | nem | Zenei sáv azonosítója, opcionálisan előadóval, címmel, és a hang- illetve videóhangerővel (0 és 100 között). |
| is\_trial\_reel | boolean | nem | Próba-Reelként teszi közzé. |
| graduation\_strategy | "MANUAL" \| "SS\_PERFORMANCE" | nem | Próba-Reelnél: kézzel emeled át a fő hírfolyamba, vagy a teljesítménye alapján automatikusan. |

## Választható értékek

A felsorolt mezők csak ezeket az értékeket fogadják el. Bármilyen más értékre 400-as hibát kapsz, a válasz pedig megnevezi a mezőt.

### `post_type`

| Érték | Mit jelent |
| --- | --- |
| post | Hírfolyam-bejegyzés. |
| story | Story, 24 órára. |

### `graduation_strategy`

| Érték | Mit jelent |
| --- | --- |
| MANUAL | Te emeled át a próba-Reelt a fő hírfolyamba. |
| SS\_PERFORMANCE | Az Instagram emeli át, ha jól teljesít. |

## Példák

Minden példa egy elem a `POST /public/v1/posts` kérés `posts` tömbjében. A körülötte lévő boríték minden esetben ez:

```
{
  "type": "schedule",
  "date": "2026-09-15T09:00:00.000Z",
  "shortLink": false,
  "posts": [ /* az alábbi elem */ ]
}
```

Kód másolása

### Hírfolyam-bejegyzés egy képpel

```
{
  "integration": { "id": "<instagram-csatorna>" },
  "value": [{
    "content": "<p>Új a kínálatunkban.</p>",
    "image": [{ "id": "<media>", "path": "https://uploads.posty.hu/kep.jpg" }]
  }],
  "settings": { "__type": "instagram", "post_type": "post" }
}
```

Kód másolása

### Körkép, három képpel

```
{
  "integration": { "id": "<instagram-csatorna>" },
  "value": [{
    "content": "<p>Lapozz végig a részleteken.</p>",
    "image": [
      { "id": "<media-1>", "path": "https://uploads.posty.hu/1.jpg" },
      { "id": "<media-2>", "path": "https://uploads.posty.hu/2.jpg" },
      { "id": "<media-3>", "path": "https://uploads.posty.hu/3.jpg" }
    ]
  }],
  "settings": { "__type": "instagram", "post_type": "post" }
}
```

Kód másolása

### Story

Egyetlen kép vagy videó. Több elem esetén a platform visszautasítja.

```
{
  "integration": { "id": "<instagram-csatorna>" },
  "value": [{
    "content": "<p>Ma nyitunk.</p>",
    "image": [{ "id": "<media>", "path": "https://uploads.posty.hu/story.jpg" }]
  }],
  "settings": { "__type": "instagram", "post_type": "story" }
}
```

Kód másolása

### Együttműködő fiókkal

A collaborators elemei felhasználóneveket várnak, @ jel nélkül.

```
{
  "integration": { "id": "<instagram-csatorna>" },
  "value": [{
    "content": "<p>Közös munka.</p>",
    "image": [{ "id": "<media>", "path": "https://uploads.posty.hu/kep.jpg" }]
  }],
  "settings": {
    "__type": "instagram",
    "post_type": "post",
    "collaborators": [{ "label": "masik_fiok" }]
  }
}
```

Kód másolása

A csatorna azonosítóját a [csatornalista](https://posty.hu/dokumentacio/api/vegpontok/csatornak) adja, a képek és videók `path` értékét pedig a [médiafeltöltés](https://posty.hu/dokumentacio/api/vegpontok/media-feltoltes). A bekötött fiókra érvényes, pontos sémát a [beállítássémát visszaadó végpont](https://posty.hu/dokumentacio/api/vegpontok/csatorna-sema) adja vissza. Parancssorból ugyanez a `--settings` kapcsolóval megy, lásd a [CLI-példákat](https://posty.hu/dokumentacio/cli/peldak).

Dokumentációs oldalak

Hiányzik valami erről az oldalról? Írj a [norbert@posty.hu](mailto:norbert@posty.hu) címre, vagy használd a [Segítség](https://posty.hu/segitseg) oldal űrlapját.