Ghost: posztolási szabályok és beállítások
Mit fogad el a Ghost csatorna a Postyban: média, korlátok, kötelező mezők, és a settings objektum mezői az API-hoz.
Alapadatok
ghostBejegyzéstípusok
Ugyanaz a csatorna többféle alakú bejegyzést fogad el, és mindegyik mást követel meg. A táblázatból kiderül, melyikhez mi kell.
| Típus | Média | Megjegyzés |
|---|---|---|
| Bejegyzés | kiemelt kép a main_image mezőben | A cím kötelező. Hírlevél nem megy ki. |
Szabályok
- A bekötéshez az oldal URL-je és egy egyéni integráció Admin API kulcsa kell. Az integrációt a Ghost Adminban készíted el: Settings, Integrations, Add custom integration.
- A Posty az ütemezett időpontban hozza létre a bejegyzést. Hírlevelet nem küld.
- A bejegyzés szövege HTML-ként megy ki.
Beállításmezők
Ezek a mezők a bejegyzés settings objektumába kerülnek, a __type mező mellé. A felületen ugyanezeket a csatorna lenyíló beállításszakaszában töltöd ki.
| Mező | Típus | Kötelező | Mit csinál |
|---|---|---|---|
| title | string, legfeljebb 255 karakter | igen | A bejegyzés címe. |
| status | "published" | "draft" | nem | Megjelenik az ütemezett időpontban, vagy piszkozatként kerül a Ghostba. Alapértelmezés: "published". |
| tags | string | nem | A címkék nevei, vesszővel elválasztva. |
| excerpt | string, legfeljebb 300 karakter | nem | Egyéni kivonat. |
| main_image | médiaobjektum | nem | A kiemelt kép a médiatárból. |
Választható értékek
A felsorolt mezők csak ezeket az értékeket fogadják el. Bármilyen más értékre 400-as hibát kapsz, a válasz pedig megnevezi a mezőt.
status
| Érték | Mit jelent |
|---|---|
| published | Megjelenik az ütemezett időpontban. Ez az alapértelmezés. |
| draft | Az ütemezett időpontban piszkozatként kerül a Ghostba. |
Példák
Minden példa egy elem a POST /public/v1/posts kérés posts tömbjében. A körülötte lévő boríték minden esetben ez:
{
"type": "schedule",
"date": "2026-09-15T09:00:00.000Z",
"shortLink": false,
"posts": [ /* az alábbi elem */ ]
}Bejegyzés címkékkel és kivonattal
{
"integration": { "id": "<ghost-csatorna>" },
"value": [{ "content": "<p>Minden, ami ebben a hónapban változott.</p>", "image": [] }],
"settings": {
"__type": "ghost",
"title": "Mi változott októberben",
"status": "published",
"tags": "hírek, termék",
"excerpt": "Minden, ami ebben a hónapban változott, egy helyen.",
"main_image": { "id": "<media>", "path": "https://uploads.posty.hu/october.jpg" }
}
}A csatorna azonosítóját a csatornalista adja, a képek és videók path értékét pedig a médiafeltöltés. A bekötött fiókra érvényes, pontos sémát a beállítássémát visszaadó végpont adja vissza. Parancssorból ugyanez a --settings kapcsolóval megy, lásd a CLI-példákat.