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.
Eckdaten
xBeitragstypen
Derselbe Kanal akzeptiert mehrere Beitragstypen. Jeder verlangt etwas anderes. Die Tabelle zeigt, was du wofür brauchst.
| Typ | Medien | Hinweis |
|---|---|---|
| Text | keine | Der häufigste. Nur der Text zählt zum Zeichenlimit. |
| Bild | höchstens 4 Bilder | Die vier Bilder erscheinen in einem Beitrag, als Raster. |
| Video | 1 Video | Zu einem Video kannst du kein Bild hinzufügen. |
| Thread | pro Teil eigene | Die weiteren Elemente im value-Array hängen als Antworten an den ersten. |
Regeln
- Den Thread schreibst du als weitere Teile des Beitrags: der erste Teil ist der Beitrag, der Rest hängt als Antworten darunter.
- Das Zeichenlimit hängt vom Kontotyp ab, deshalb zeigt der Editor den für das verbundene Konto freigeschalteten Wert.
Einstellungsfelder
Diese Felder kommen in das settings-Objekt des Beitrags, neben das Feld __type. In der Oberfläche füllst du dieselben im Einstellungsbereich des Kanals aus.
| Feld | Typ | Pflicht | Was es tut |
|---|---|---|---|
| who_can_reply_post | "everyone" | "following" | "mentionedUsers" | "subscribers" | "verified" | ja | Wer auf den Beitrag antworten darf. |
| community | string | nein | Die vollständige URL einer X-Community, im Format https://x.com/i/communities/<Zahl>. Leer gelassen geht der Beitrag auf deine eigene Timeline. |
| made_with_ai | boolean | nein | Markiert den Beitrag als mit KI erstellt. |
| paid_partnership | boolean | nein | Markiert den Beitrag als bezahlte Partnerschaft. |
Zulässige Werte
Die aufgeführten Felder akzeptieren nur diese Werte. Bei jedem anderen Wert bekommst du einen 400er-Fehler. Die Antwort nennt das Feld.
who_can_reply_post
| Wert | Bedeutung |
|---|---|
| everyone | Jeder kann antworten. |
| following | Nur Leute, denen du folgst. |
| mentionedUsers | Nur die im Beitrag Erwähnten. |
| subscribers | Nur deine Abonnenten. |
| verified | Nur verifizierte Konten. |
Beispiele
Jedes Beispiel ist ein Element im posts-Array der Anfrage POST /public/v1/posts. Der Rahmen darum ist immer dieser:
{
"type": "schedule",
"date": "2026-09-15T09:00:00.000Z",
"shortLink": false,
"posts": [ /* az alábbi elem */ ]
}Textbeitrag
{
"integration": { "id": "<x-csatorna>" },
"value": [{ "content": "<p>Ma új funkciót adtunk ki.</p>", "image": [] }],
"settings": { "__type": "x", "who_can_reply_post": "everyone" }
}Beitrag mit zwei Bildern
Die path-Werte gibt der Medien-Upload zurück. Eine beliebige URL aus dem Internet funktioniert nicht.
{
"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" }
}Thread, mit zwei Minuten Verzögerung
Das erste Element ist der Beitrag, die übrigen hängen als Antworten darunter. delay ist in Minuten.
{
"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" }
}Beitrag in eine Community
Das Feld community erwartet die vollständige URL der X-Community.
{
"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"
}
}Die Kanalliste liefert die Kanal-ID, der Medien-Upload den path-Wert für Bilder und Videos. Das genaue Schema für das verbundene Konto gibt der Endpunkt für das Einstellungsschema zurück. Von der Kommandozeile aus geht dasselbe mit dem Flag --settings, siehe die CLI-Beispiele.