Platformok

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.

Alapadatok

Platform

TikTok

Karakterkorlát

A platform nem ad meg általános korlátot.

Média

Kötelező: egy videó, vagy egy vagy több kép fotóbejegyzéshez.

settings.__type

tiktok

Kötelező mezők

content_posting_method, privacy_level, duet, stitch, comment, autoAddMusic, brand_content_toggle, brand_organic_toggle

A platform oldala

TikTok ütemező

Bejegyzé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
Videó, közzététel	1 videó	content_posting_method: DIRECT_POST. Ez az, ami tényleg kiteszi.
Fotóbejegyzés	1 vagy több kép	A duett, az összefűzés és az AI-jelölés fotónál nem értelmezett.
Beküldés a postaládába	1 videó	content_posting_method: UPLOAD. A felhasználónak 24 órán belül kézzel kell befejeznie.

Szabályok

A közzétételi mód dönti el, mi történik. A DIRECT_POST tényleg közzéteszi a bejegyzést; az UPLOAD csak beteszi a felhasználó TikTok-alkalmazásának postaládájába, ahol 24 órán belül kézzel kell befejeznie, különben elveszik.
UPLOAD módban a TikTok a címen kívül minden más beállítást eldob.
A láthatóságnak szándékosan nincs alapértéke: a TikTok szabályzata szerint a közzétevőnek kell választania.
A duett, az összefűzés és az AI-jelölés csak videónál értelmezett, a TikTok fotóbejegyzésnél nem kezeli őket.

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
content_posting_method	"DIRECT_POST" \| "UPLOAD"	igen	Közzététel, vagy csak beküldés a felhasználó postaládájába.
privacy_level	"PUBLIC_TO_EVERYONE" \| "MUTUAL_FOLLOW_FRIENDS" \| "FOLLOWER_OF_CREATOR" \| "SELF_ONLY"	igen	A bejegyzés láthatósága. DIRECT_POST esetén kötelező, alapértéke nincs.
title	string, legfeljebb 90 karakter	nem	A bejegyzés címe. UPLOAD módban ez az egyetlen beállítás, amit a TikTok megtart.
duet	boolean	igen	Engedélyezi a duettet. Csak videónál.
stitch	boolean	igen	Engedélyezi az összefűzést. Csak videónál.
comment	boolean	igen	Engedélyezi a hozzászólásokat.
autoAddMusic	"yes" \| "no"	igen	Zene automatikus hozzáadása. Csak fotóbejegyzésnél.
brand_content_toggle	boolean	igen	Márkázott tartalom jelölése.
brand_organic_toggle	boolean	igen	Saját márkatartalom jelölése.
video_made_with_ai	boolean	nem	AI-val készített videóként jelöli meg. Csak videóná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.

`content_posting_method`

Érték	Mit jelent
DIRECT_POST	A TikTok közzéteszi a bejegyzést.
UPLOAD	Csak a postaládába kerül. A TikTok a címen kívül minden beállítást eldob.

`privacy_level`

Érték	Mit jelent
PUBLIC_TO_EVERYONE	Nyilvános.
MUTUAL_FOLLOW_FRIENDS	Csak a kölcsönös követőknek.
FOLLOWER_OF_CREATOR	Csak a követőknek.
SELF_ONLY	Csak neked.

`autoAddMusic`

Érték	Mit jelent
yes	A TikTok zenét tesz a fotóbejegyzés alá.
no	Zene nélkül.

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 */ ]
}

Videó, nyilvánosan

A láthatóságnak nincs alapértéke: a TikTok szabályzata szerint választani kell.

{
  "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
  }
}

Fotóbejegyzés

A duet, a stitch és a video_made_with_ai fotónál figyelmen kívül marad.

{
  "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
  }
}

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.

Hiányzik valami erről az oldalról? Írj a [email protected] címre, vagy használd a Segítség oldal űrlapját.