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.
Základní údaje
xTypy příspěvků
Stejný kanál přijímá víc druhů příspěvků. Každý má jiné požadavky. Tabulka ukáže, co k čemu potřebujete.
| Typ | Média | Poznámka |
|---|---|---|
| Textový | žádné | Nejčastější. Do limitu znaků se počítá jen text. |
| Obrázkový | nejvýše 4 obrázky | Čtyři obrázky se zobrazí v jednom příspěvku, v mřížce. |
| Video | 1 video | K videu nejde přidat obrázek. |
| Vlákno | každá část má vlastní | Další položky pole value se připojí jako odpovědi k první. |
Pravidla
- Vlákno píšete jako další části příspěvku: první část je příspěvek, zbytek se pod něj připojí jako odpovědi.
- Znakový limit závisí na typu účtu, proto editor ukazuje hodnotu povolenou pro propojený účet.
Pole nastavení
Tato pole jdou do objektu settings příspěvku, vedle pole __type. V rozhraní je vyplníte v rozbalovací sekci nastavení kanálu.
| Pole | Typ | Povinné | Co dělá |
|---|---|---|---|
| who_can_reply_post | "everyone" | "following" | "mentionedUsers" | "subscribers" | "verified" | ano | Kdo může na příspěvek odpovídat. |
| community | string | ne | Celá URL komunity na X, ve tvaru https://x.com/i/communities/<číslo>. Když ji necháte prázdnou, příspěvek jde na vaši vlastní časovou osu. |
| made_with_ai | boolean | ne | Označí příspěvek jako vytvořený pomocí AI. |
| paid_partnership | boolean | ne | Označí příspěvek jako placenou spolupráci. |
Povolené hodnoty
Uvedená pole přijímají jen tyto hodnoty. U jakékoli jiné hodnoty dostanete chybu 400 a odpověď pojmenuje pole.
who_can_reply_post
| Hodnota | Co znamená |
|---|---|
| everyone | Odpovědět může kdokoli. |
| following | Jen lidé, které sledujete. |
| mentionedUsers | Jen lidé zmínění v příspěvku. |
| subscribers | Jen vaši předplatitelé. |
| verified | Jen ověřené účty. |
Příklady
Každý příklad je jedna položka v poli posts požadavku POST /public/v1/posts. Obálka kolem něj je vždy tato:
{
"type": "schedule",
"date": "2026-09-15T09:00:00.000Z",
"shortLink": false,
"posts": [ /* az alábbi elem */ ]
}Textový příspěvek
{
"integration": { "id": "<x-csatorna>" },
"value": [{ "content": "<p>Ma új funkciót adtunk ki.</p>", "image": [] }],
"settings": { "__type": "x", "who_can_reply_post": "everyone" }
}Příspěvek se dvěma obrázky
Hodnoty path vrací nahrání médií. Libovolná URL z internetu nebude fungovat.
{
"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" }
}Vlákno se zpožděním dvou minut
První položka je příspěvek, zbylé se připojí jako odpovědi pod něj. delay je v minutách.
{
"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" }
}Příspěvek do komunity
Pole community očekává úplnou URL komunity na X.
{
"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"
}
}Identifikátor kanálu získáte ze seznamu kanálů. Hodnoty path u obrázků a videí z nahrání médií. Přesné schéma platné pro propojený účet vrací endpoint se schématem nastavení. Z příkazové řádky to samé uděláte přepínačem --settings, viz příklady CLI.