Beiträge

Beitrag erstellen: POST /posts

Poszt létrehozása: piszkozat, ütemezés vagy azonnali közzététel, egy vagy több csatornára.

Der Pfad

Methode und Pfad

POSThttps://api.posty.hu/public/v1/posts

Berechtigung

posts:draft (közzétételhez posts:publish is)

operationId

createPost

Erstellt einen Entwurf, plant einen Beitrag oder veröffentlicht sofort, auf einem oder mehreren Kanälen. Das ist der einzige Schreib-Endpunkt, den eine Integration regelmäßig aufruft.

Wenn du eine bestehende Gruppen-ID schickst, aktualisiert er den vorhandenen Beitrag, statt einen zweiten anzulegen.

Parameter

Name	Ort	Typ	Pflicht	Was es tut
type	törzs	"draft" \| "schedule" \| "now"	ja	Entwurf, Planung oder sofortige Veröffentlichung. schedule und now brauchen den Scope posts:publish.
date	törzs	ISO 8601 Datum	ja	Der Zeitpunkt der Veröffentlichung, in UTC.
shortLink	törzs	boolean	nein	Ob Posty die Links im Text kürzen soll.
tags	törzs	Array	nein	Interne Tags am Beitrag. Sie gehen nicht an die Plattform. Du filterst damit nur in Posty.
posts	törzs	Array	ja	Ein Eintrag pro Kanal. In jedem stehen die integration.id, das value-Array (der Beitrag und seine Kommentare) und optional die plattformspezifischen settings.

Anfrage

curl -X POST https://api.posty.hu/public/v1/posts \
  -H "Authorization: psty_a_kulcsod" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "schedule",
    "date": "2026-09-15T09:00:00.000Z",
    "shortLink": false,
    "posts": [{
      "integration": { "id": "clx1a2b3c4d5e6f7g8h9" },
      "value": [
        { "content": "<p>Sziasztok!</p>", "image": [] },
        { "content": "<p>Az első hozzászólás.</p>", "image": [], "delay": 5 }
      ],
      "settings": { "__type": "x", "who_can_reply_post": "everyone" }
    }]
  }'

Antwort

Beispiel für die Form der Antwort. Das verbindliche Schema, Feld für Feld, steht im OpenAPI-Dokument.

[
  { "postId": "clp0s7t8u9v0w1x2", "integration": "clx1a2b3c4d5e6f7g8h9" }
]

Wichtig

content erwartet HTML, keinen Klartext. Ein Absatz steht zwischen <p>…</p>.
Das erste Element im value-Array ist der Beitrag, der Rest geht als Kommentare darunter raus. delay gibt in Minuten an, um wie viel später.
Das Bild kommt aus der Mediathek: Lade zuerst über den Endpunkt /upload oder /upload-from-url hoch, und übergib den path-Wert aus der Antwort.
settings.__type ist die Plattform-ID. Die erwarteten Felder stehen im Einstellungsschema des Kanals.
Die sofortige Veröffentlichung ist unumkehrbar und ruft externe Systeme auf. Schütze Netzwerkwiederholungen mit einem Idempotenzschlüssel.

Siehe auch

Authentifizierung: der Schlüssel und die Scopes.
Fehler und Limits: die Fehlerantworten und das Aufruflimit.
Alle Endpunkte: die vollständige Liste.

Fehlt etwas auf dieser Seite? Schreib eine E-Mail an [email protected] oder nutze auf der Hilfeseite das Formular.