Příspěvky

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

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

Cesta

Metoda a cesta

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

Oprávnění

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

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ázev	Umístění	Typ	Povinné	Co dělá
type	törzs	"draft" \| "schedule" \| "now"	ano	Koncept, naplánování nebo okamžité publikování. schedule a now vyžadují oprávnění posts:publish.
date	törzs	ISO 8601 datum	ano	Čas publikování, v UTC.
shortLink	törzs	boolean	ne	Jestli má Posty zkrátit odkazy v textu.
tags	törzs	pole	ne	Interní štítky u příspěvku. Na platformu se neposílají, v Posty s nimi jen filtrujete.
posts	törzs	pole	ano	Jeden 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_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" }
    }]
  }'

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í

Autentizace: klíč a scope.
Chyby a limity: chybové odpovědi a limit volání.
Všechny endpointy: kompletní seznam.

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ář.