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
instagram, instagram-standaloneBejegyzé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 */ ]
}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ö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" }
}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" }
}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" }]
}
}A csatorna azonosítóját a csatornalista adja, a képek és videók path értékét pedig a médiafeltöltés. A bekötött fiókra érvényes, pontos sémát a beállítássémát visszaadó végpont adja vissza. Parancssorból ugyanez a --settings kapcsolóval megy, lásd a CLI-példákat.