Ghost: pravidla publikování a nastavení
Co kanál Ghost v Posty přijímá: média, limity, povinná pole a pole objektu settings pro API.
Základní údaje
ghostTypy příspěvků
Stejný kanál přijímá víc druhů příspěvků. Každý má jiné požadavky. Tabulka ukáže, co k čemu potřebujete.
| Typ | Média | Poznámka |
|---|---|---|
| Příspěvek | hlavní obrázek v main_image | Název je povinný. Newsletter neodejde. |
Pravidla
- K propojení potřebujete URL webu a Admin API klíč vlastní integrace. Integraci vytvoříte v Ghost Admin, v části Settings, Integrations, Add custom integration.
- Posty vytvoří příspěvek v naplánovaný čas. Newsletter neposílá.
- Text příspěvku odchází jako HTML.
Pole nastavení
Tato pole jdou do objektu settings příspěvku, vedle pole __type. V rozhraní je vyplníte v rozbalovací sekci nastavení kanálu.
| Pole | Typ | Povinné | Co dělá |
|---|---|---|---|
| title | string, nejvýše 255 znaků | ano | Název příspěvku. |
| status | "published" | "draft" | ne | Vyjde v naplánovaný čas, nebo se uloží jako koncept v Ghostu. Výchozí je "published". |
| tags | string | ne | Názvy štítků oddělené čárkami. |
| excerpt | string, nejvýše 300 znaků | ne | Vlastní perex. |
| main_image | objekt média | ne | Hlavní obrázek z knihovny médií. |
Povolené hodnoty
Uvedená pole přijímají jen tyto hodnoty. U jakékoli jiné hodnoty dostanete chybu 400 a odpověď pojmenuje pole.
status
| Hodnota | Co znamená |
|---|---|
| published | Vyjde v naplánovaný čas. Výchozí hodnota. |
| draft | V naplánovaný čas se uloží jako koncept v Ghostu. |
Příklady
Každý příklad je jedna položka v poli posts požadavku POST /public/v1/posts. Obálka kolem něj je vždy tato:
{
"type": "schedule",
"date": "2026-09-15T09:00:00.000Z",
"shortLink": false,
"posts": [ /* položka níže */ ]
}Příspěvek se štítky a perexem
{
"integration": { "id": "<ghost-kanal>" },
"value": [{ "content": "<p>Všechno, co se tento měsíc změnilo.</p>", "image": [] }],
"settings": {
"__type": "ghost",
"title": "Co se změnilo v říjnu",
"status": "published",
"tags": "novinky, produkt",
"excerpt": "Všechno, co se tento měsíc změnilo, na jednom místě.",
"main_image": { "id": "<media>", "path": "https://uploads.posty.hu/october.jpg" }
}
}Identifikátor kanálu získáte ze seznamu kanálů. Hodnoty path u obrázků a videí z nahrání médií. Přesné schéma platné pro propojený účet vrací endpoint se schématem nastavení. Z příkazové řádky to samé uděláte přepínačem --settings, viz příklady CLI.