Bejegyzések

Bejegyzés létrehozása: POST /posts

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

Az útvonal

Metódus és útvonal
POSThttps://api.posty.hu/public/v1/posts
Jogosultság
posts:draft (közzétételhez posts:publish is)
operationId
createPost

Piszkozatot hoz létre, bejegyzést ütemez, vagy azonnal közzétesz, egy vagy több csatornára. Ez az egyetlen író végpont, amit egy integráció rendszeresen hív.

Ha meglévő csoportazonosítót küldesz, a meglévő bejegyzést frissíti, nem hoz létre másodikat.

Paraméterek

NévHolTípusKötelezőMit csinál
typetörzs"draft" | "schedule" | "now"igenPiszkozat, ütemezés vagy azonnali közzététel. A schedule és a now posts:publish jogosultságot kér.
datetörzsISO 8601 dátumigenA közzététel időpontja, UTC-ben.
shortLinktörzsbooleannemRövidítse-e a Posty a szövegben lévő linkeket.
tagstörzstömbnemBelső címkék a bejegyzésen. A platformra nem mennek ki, csak a Postyban szűrsz velük.
poststörzstömbigenCsatornánként egy elem. Mindegyikben az integration.id, a value tömb (a bejegyzés és a hozzászólásai), és opcionálisan a platformspecifikus settings.

Kérés

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" }
    }]
  }'

Válasz

Példa a válasz alakjára. A mezőnkénti, kötelező érvényű sémát az OpenAPI dokumentum tartalmazza.

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

Fontos

  • A content HTML-t vár, nem sima szöveget. Egy bekezdés <p>…</p> között áll.
  • A value tömb első eleme a bejegyzés, a többi hozzászólásként megy ki alá. A delay percben adja meg, mennyivel később.
  • A kép a médiakönyvtárból való: előbb tölts fel a /upload vagy a /upload-from-url végponttal, és a válaszban kapott path értéket add át.
  • A settings.__type a platform azonosítója. A várt mezőket a csatorna beállítássémája sorolja fel.
  • Az azonnali közzététel visszafordíthatatlan, és külső rendszereket hív. Idempotenciakulccsal védd a hálózati újrapróbálkozást.

Kapcsolódó

Hiányzik valami erről az oldalról? Írj a [email protected] címre, vagy használd a Segítség oldal űrlapját.