Pinterest: posztolási szabályok és beállítások
Mit fogad el a Pinterest csatorna a Postyban: média, korlátok, kötelező mezők, és a settings objektum mezői az API-hoz.
Alapadatok
pinterestBejegyzé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 |
|---|---|---|
| Pin képpel | 1 kép, kötelező | A tábla kötelező, és azonosítót vár. |
| Pin videóval | 1 videó | Nincs külön megjegyzés. |
Szabályok
- A tábla kötelező, és azonosítót vár, nem nevet. A táblák listáját a csatorna eszközhívásával kéred le.
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 |
|---|---|---|---|
| board | string (azonosító) | igen | A cél tábla azonosítója. |
| title | string, legfeljebb 100 karakter | nem | A pin címe. |
| link | string (URL) | nem | A pin cél-URL-je. |
| dominant_color | string | nem | A pin domináns színe, hexadecimális kóddal. |
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 */ ]
}Pin cél-URL-lel
A tábla azonosítóját a csatorna eszközhívása adja: POST /integration-trigger/:id, methodName „boards”.
{
"integration": { "id": "<pinterest-csatorna>" },
"value": [{
"content": "<p>A pin leírása.</p>",
"image": [{ "id": "<media>", "path": "https://uploads.posty.hu/pin.jpg" }]
}],
"settings": {
"__type": "pinterest",
"board": "<tabla-azonosito>",
"title": "A pin címe",
"link": "https://pelda.hu/termek"
}
}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.