X (Twitter): posztolási szabályok és beállítások
Mit fogad el a X (Twitter) csatorna a Postyban: média, korlátok, kötelező mezők, és a settings objektum mezői az API-hoz.
Alapadatok
xBejegyzé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 |
|---|---|---|
| Szöveges | nincs | A leggyakoribb. Csak a szöveg számít a karakterkorlátba. |
| Képes | legfeljebb 4 kép | A négy kép egy bejegyzésben jelenik meg, rácsban. |
| Videós | 1 videó | Videó mellé nem mehet kép. |
| Szál | részenként saját | A value tömb további elemei válaszként fűződnek az elsőre. |
Szabályok
- A szálat a bejegyzés további részeiként írod meg: az első rész a bejegyzés, a többi válaszként fűződik alá.
- A karakterkorlát a fiók típusától függ, ezért a szerkesztő a bekötött fiókra feloldott értéket mutatja.
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 |
|---|---|---|---|
| who_can_reply_post | "everyone" | "following" | "mentionedUsers" | "subscribers" | "verified" | igen | Ki válaszolhat a bejegyzésre. |
| community | string | nem | Egy X-közösség teljes URL-je, https://x.com/i/communities/<szám> alakban. Üresen hagyva a bejegyzés a saját idővonalra megy. |
| made_with_ai | boolean | nem | Megjelöli a bejegyzést AI-val készítettként. |
| paid_partnership | boolean | nem | Fizetett együttműködésként jelöli meg a bejegyzést. |
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.
who_can_reply_post
| Érték | Mit jelent |
|---|---|
| everyone | Bárki válaszolhat. |
| following | Csak akiket követsz. |
| mentionedUsers | Csak a bejegyzésben megjelöltek. |
| subscribers | Csak az előfizetőid. |
| verified | Csak hitelesített fiókok. |
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 */ ]
}Szöveges bejegyzés
{
"integration": { "id": "<x-csatorna>" },
"value": [{ "content": "<p>Ma új funkciót adtunk ki.</p>", "image": [] }],
"settings": { "__type": "x", "who_can_reply_post": "everyone" }
}Bejegyzés két képpel
A path értékeket a médiafeltöltés adja vissza. Tetszőleges internetes URL nem működik.
{
"integration": { "id": "<x-csatorna>" },
"value": [{
"content": "<p>Két kép egy bejegyzésben.</p>",
"image": [
{ "id": "<media-1>", "path": "https://uploads.posty.hu/egy.png" },
{ "id": "<media-2>", "path": "https://uploads.posty.hu/ketto.png" }
]
}],
"settings": { "__type": "x", "who_can_reply_post": "everyone" }
}Szál, két perc késleltetéssel
Az első elem a bejegyzés, a többi válaszként fűződik alá. A delay percben értendő.
{
"integration": { "id": "<x-csatorna>" },
"value": [
{ "content": "<p>1/3 Kezdjük egy rövid szállal.</p>", "image": [] },
{ "content": "<p>2/3 A második rész.</p>", "image": [], "delay": 2 },
{ "content": "<p>3/3 És a zárás.</p>", "image": [], "delay": 2 }
],
"settings": { "__type": "x", "who_can_reply_post": "everyone" }
}Bejegyzés egy közösségbe
A community mező az X-közösség teljes URL-jét várja.
{
"integration": { "id": "<x-csatorna>" },
"value": [{ "content": "<p>Kérdés a közösséghez.</p>", "image": [] }],
"settings": {
"__type": "x",
"who_can_reply_post": "everyone",
"community": "https://x.com/i/communities/1493446837214187523"
}
}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.