Příspěvky

Vytvoření příspěvku: POST /posts

Vytvoří příspěvek: koncept, naplánovaný nebo okamžitě publikovaný, na jeden či více kanálů.

Cesta

Metoda a cesta
POSThttps://api.posty.hu/public/v1/posts
Oprávnění
posts:draft (pro publikování také posts:publish)
operationId
createPost

Vytvoří koncept, naplánuje příspěvek, nebo ho hned publikuje, na jeden nebo víc kanálů. Je to jediný zapisovací endpoint, který integrace volá pravidelně.

Když pošlete existující identifikátor skupiny, aktualizuje stávající příspěvek, místo aby vytvořil druhý.

Parametry

NázevUmístěníTypPovinnéCo dělá
typetělo"draft" | "schedule" | "now"anoKoncept, naplánování nebo okamžité publikování. schedule a now vyžadují oprávnění posts:publish.
datetěloISO 8601 datumanoČas publikování, v UTC.
shortLinktělobooleanneJestli má Posty zkrátit odkazy v textu.
tagstělopoleneInterní štítky u příspěvku. Na platformu se neposílají, v Posty s nimi jen filtrujete.
poststělopoleanoJeden prvek na kanál. V každém je integration.id, pole value (příspěvek a jeho komentáře) a volitelně settings specifická pro platformu.

Požadavek

curl -X POST https://api.posty.hu/public/v1/posts \
  -H "Authorization: psty_vas_klic" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "schedule",
    "date": "2026-09-15T09:00:00.000Z",
    "shortLink": false,
    "posts": [{
      "integration": { "id": "clx1a2b3c4d5e6f7g8h9" },
      "value": [
        { "content": "<p>Dobrý den všem!</p>", "image": [] },
        { "content": "<p>První komentář.</p>", "image": [], "delay": 5 }
      ],
      "settings": { "__type": "x", "who_can_reply_post": "everyone" }
    }]
  }'

Odpověď

Příklad tvaru odpovědi. Závazné schéma, pole po poli, je v dokumentu OpenAPI.

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

Důležité

  • content očekává HTML, ne prostý text. Odstavec je mezi <p>…</p>.
  • První prvek pole value je příspěvek, zbytek jde ven jako komentáře pod ním. delay říká v minutách, o kolik později.
  • Obrázek pochází z knihovny médií: nejdřív ho nahrajte endpointem /upload nebo /upload-from-url a předejte hodnotu path z odpovědi.
  • settings.__type je identifikátor platformy. Očekávaná pole vypisuje schéma nastavení kanálu.
  • Okamžité publikování je nevratné a volá externí systémy. Síťové opakování chraňte klíčem idempotence.

Související

Něco vám na této stránce chybí? Napište na [email protected] nebo na stránce Nápověda vyplňte formulář.