Pinterest: pravidla publikování a nastavení
Co kanál Pinterest v Posty přijímá: média, limity, povinná pole a pole objektu settings pro API.
Základní údaje
pinterestTypy 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 |
|---|---|---|
| Pin s obrázkem | 1 obrázek, povinné | Nástěnka je povinná a očekává identifikátor. |
| Pin s videem | 1 video a 1 úvodní obrázek | Úvodní obrázek je druhá příloha. |
Pravidla
- Nástěnka je povinná a čeká identifikátor, ne název. Seznam nástěnek si stáhnete voláním nástroje kanálu.
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á |
|---|---|---|---|
| board | string (identifikátor) | ano | Identifikátor cílové nástěnky. |
| title | string, nejvýše 100 znaků | ne | Název pinu. |
| link | string (URL) | ne | Cílová URL pinu. |
| dominant_color | string | ne | Dominantní barva pinu, hexadecimálním kódem. |
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 */ ]
}Pin s cílovou URL
Identifikátor nástěnky vrátí volání nástroje kanálu: POST /integration-trigger/:id, methodName „boards”.
{
"integration": { "id": "<pinterest-kanal>" },
"value": [{
"content": "<p>Popis pinu.</p>",
"image": [{ "id": "<media>", "path": "https://uploads.posty.hu/pin.jpg" }]
}],
"settings": {
"__type": "pinterest",
"board": "<id-nastenky>",
"title": "Název pinu",
"link": "https://example.com/produkt"
}
}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.