TikTok: posztolási szabályok és beállítások
Mit fogad el a TikTok csatorna a Postyban: média, korlátok, kötelező mezők, és a settings objektum mezői az API-hoz.
Základní údaje
tiktokTypy 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 |
|---|---|---|
| Video, publikování | 1 video | content_posting_method: DIRECT_POST. Tohle příspěvek opravdu zveřejní. |
| Příspěvek s fotkami | 1 nebo více obrázků | U fotek neplatí duet, stitch ani označení AI. |
| Odeslání do schránky | 1 video | content_posting_method: UPLOAD. Do 24 hodin to musíte dokončit ručně. |
Pravidla
- Režim publikování rozhodne, co se stane. DIRECT_POST příspěvek opravdu publikuje. UPLOAD ho jen vloží do schránky v aplikaci TikTok uživatele. Tam ho musí do 24 hodin ručně dokončit, jinak se ztratí.
- V režimu UPLOAD TikTok zahodí všechna nastavení kromě názvu.
- Viditelnost záměrně nemá výchozí hodnotu: podle pravidel TikToku ji musí zvolit ten, kdo publikuje.
- Duet, stitch a označení AI platí jen u videa. U příspěvku s fotkami je TikTok nebere v potaz.
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á |
|---|---|---|---|
| content_posting_method | "DIRECT_POST" | "UPLOAD" | ano | Publikování, nebo jen odeslání do schránky uživatele. |
| privacy_level | "PUBLIC_TO_EVERYONE" | "MUTUAL_FOLLOW_FRIENDS" | "FOLLOWER_OF_CREATOR" | "SELF_ONLY" | ano | Viditelnost příspěvku. U DIRECT_POST je povinná, výchozí hodnotu nemá. |
| title | string, nejvýše 90 znaků | ne | Název příspěvku. V režimu UPLOAD je to jediné nastavení, které si TikTok nechá. |
| duet | boolean | ano | Povolí duet. Jen u videa. |
| stitch | boolean | ano | Povolí stitch. Jen u videa. |
| comment | boolean | ano | Povolí komentáře. |
| autoAddMusic | "yes" | "no" | ano | Automatické přidání hudby. Jen u příspěvku s fotkami. |
| brand_content_toggle | boolean | ano | Označení jako značkový obsah. |
| brand_organic_toggle | boolean | ano | Označení jako vlastní značkový obsah. |
| video_made_with_ai | boolean | ne | Označí ho jako video vytvořené pomocí AI. Jen u videa. |
Povolené hodnoty
Uvedená pole přijímají jen tyto hodnoty. U jakékoli jiné hodnoty dostanete chybu 400 a odpověď pojmenuje pole.
content_posting_method
| Hodnota | Co znamená |
|---|---|
| DIRECT_POST | TikTok příspěvek publikuje. |
| UPLOAD | Příspěvek skončí jen ve schránce. TikTok zahodí všechna nastavení kromě názvu. |
privacy_level
| Hodnota | Co znamená |
|---|---|
| PUBLIC_TO_EVERYONE | Veřejné. |
| MUTUAL_FOLLOW_FRIENDS | Jen vzájemným sledujícím. |
| FOLLOWER_OF_CREATOR | Jen sledujícím. |
| SELF_ONLY | Jen vám. |
autoAddMusic
| Hodnota | Co znamená |
|---|---|
| yes | TikTok pod příspěvek s fotkami přidá hudbu. |
| no | Bez hudby. |
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": [ /* az alábbi elem */ ]
}Video, veřejně
Viditelnost nemá výchozí hodnotu. Podle pravidel TikToku ji musíte vybrat.
{
"integration": { "id": "<tiktok-csatorna>" },
"value": [{
"content": "<p>A videó leírása.</p>",
"image": [{ "id": "<media>", "path": "https://uploads.posty.hu/video.mp4" }]
}],
"settings": {
"__type": "tiktok",
"content_posting_method": "DIRECT_POST",
"privacy_level": "PUBLIC_TO_EVERYONE",
"title": "A videó címe",
"duet": true,
"stitch": true,
"comment": true,
"autoAddMusic": "no",
"brand_content_toggle": false,
"brand_organic_toggle": false
}
}Příspěvek s fotkami
duet, stitch a video_made_with_ai se u fotek ignorují.
{
"integration": { "id": "<tiktok-csatorna>" },
"value": [{
"content": "<p>Három kép a hétvégéről.</p>",
"image": [
{ "id": "<media-1>", "path": "https://uploads.posty.hu/1.jpg" },
{ "id": "<media-2>", "path": "https://uploads.posty.hu/2.jpg" }
]
}],
"settings": {
"__type": "tiktok",
"content_posting_method": "DIRECT_POST",
"privacy_level": "PUBLIC_TO_EVERYONE",
"title": "Hétvége",
"duet": false,
"stitch": false,
"comment": true,
"autoAddMusic": "yes",
"brand_content_toggle": false,
"brand_organic_toggle": false
}
}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.