Ebben a cikkben
A TikTok Content Posting API lehetővé teszi tartalmak beküldését egy alkotó fiókjába, de a sikeresen befogadott inicializálási kérés csupán a folyamat egyik lépése. Egy megbízható Direct Post integrációhoz élő alkotói fiókinformációkra (creator_info), kifejezett láthatósági döntésre, feltöltési hozzájárulásra, médiaátvitelre és végső státuszellenőrzésre is szükség van. Ez az útmutató a TikTok hivatalos dokumentációját veti össze az Uplonic saját validációs és újrapróbálkozási implementációjával.
A tágabb tartalom-előkészítési folyamathoz érdemes elolvasni az egy videó adaptálása TikTokra, Reelsre és Shortsra című útmutatónkat. Az alábbi API-integrációs szabályok akkor is érvényesek, ha maga a forrásvideó technikailag már tökéletesen megfelel a TikTok előírásainak.
Az auditálási korlátok és a fiókfelhatalmazás két külön kérdés
A TikTok 2026-10-17-én ellenőrzött Content Sharing Guidelines dokumentációja előírja, hogy a még nem auditált (unaudited) Direct Post kliensekből származó tartalmak kizárólag privát láthatósággal jelenhetnek meg. Soha ne keverd össze a fejlesztői környezetben sikeresen lefutó API-kérést a nyilvános posztolás engedélyével: az API-kliens auditállapota, az alkotó OAuth-felhatalmazása és a kiválasztott közönség egyaránt meghatározza a kimenetelt.
A 2026-10-17-én ellenőrzött Direct Post referencia megköveteli a video.publish jogosultsági kört (scope). Önmagában az, hogy az alkalmazásod hozzáférési tokent (access token) kapott, még nem bizonyítja sem azt, hogy a felhasználó megadta ezt a konkrét scope-ot, sem azt, hogy a kliensalkalmazás jóvá van hagyva a tervezett éles használatra. A tokenek lejáratáról és frissítési szabályairól a közösségi média API-tokenek lejáratáról szóló cikkünk ad részletes áttekintést.
Használd a creator_info végpontot élő fiókkonfigurációként
A 2026-10-17-én ellenőrzött Creator Info referencia a POST /v2/post/publish/creator_info/query/ végpontot írja le. A válasz tartalmazza az alkotó identitását, az adott pillanatban választható láthatósági (privacy) opciókat, az interakciós korlátozásokat és a fiókhoz engedélyezett maximális videóhosszt. Mindig a visszaadott max_video_post_duration_sec mezőt használd validálásra ahelyett, hogy minden fióknál ugyanazt a fix időtartam-korlátot feltételeznéd.
A dokumentált, tokenenkénti kéréskorlátok (rate limits) végpontonként eltérnek. A 2026-10-17-én ellenőrzött hivatalos végpont-referenciák szerint a Creator Info percenként 20 kérést, a Direct Post inicializálás percenként 6 kérést, a státuszlekérdezés pedig percenként 30 kérést engedélyez tokenenként. Ezek percenkénti API-híváskorlátok, nem pedig napi posztolási kvóták; tervezz külön kéréskeretet minden végponthoz ahelyett, hogy egyetlen általános API-limitet alkalmaznál.
A fiókadatoknak megjelenítési szerepük is van: az alkotónak egyértelműen fel kell ismernie a célfiókot a felületen. Egy technikailag érvényes token, amely rossz fiókra mutat, továbbra is hibás publikálási eredményt okoz. A célcsatorna kezelésének termékkörnyezetét a TikTok-csatorna áttekintő oldalunk mutatja be.
Őrizd meg a felhasználó döntését az ütemezés során is
A TikTok 2026-10-17-én ellenőrzött Content Sharing Guidelines előírásai megkövetelik a láthatósági szint kézi kiválasztását a visszaadott opciók közül, a szerkeszthető tartalmi részleteket és a kifejezett feltöltési hozzájárulást. A fiókszinten letiltott interakcióknak (például komment, duett vagy stitch) a felületen is letiltva kell maradniuk. Egy felhasználói exportáló űrlap nem alakíthat át egy szerveroldali alapértelmezett (fallback) értéket úgy, mintha az a felhasználó tudatos döntése lett volna.
A 2026-10-17-én elvégzett forráskód-áttekintésünk alapján a rendszer TikTok-ága a feltöltés indítása előtt frissíti a tokent, újra lekérdezi a creator_info adatokat, és ellenőrzi a videó hosszát. A megfelelőségi ellenőrző (compliance resolver) összeveti a kifejezetten kiválasztott láthatósági szintet a fiók aktuálisan engedélyezett opcióival.
Ütemezett tartalmaknál a döntő különbséget az eltárolt jóváhagyási pillanatkép (approval snapshot) jelenti. Ha a pillanatkép olyan jóváhagyott láthatósági szintet rögzít, amely a végrehajtás pillanatában már nem érhető el a fiókon, a resolver felhasználói beavatkozást igénylő hibát dob. Ilyen pillanatkép hiányában az implementáció tartalmaz egy megengedőbb ágat, amely az általános beállításokból vezeti le a láthatóságot, és visszaeshet (fallback) egy engedélyezett értékre. Az integrációnak ettől függetlenül mindig be kell gyűjtenie és meg kell őriznie a tényleges felhasználói döntést; önmagában a sikeres szerveroldali validáció nem bizonyítja, hogy a felhasználói hozzájárulás megtörtént.
Helyi teszteset | Megfigyelt eredmény | Implementációs következmény |
|---|---|---|
A jóváhagyott láthatóság már nem szerepel a kínálatban | Felhasználói beavatkozást kérő hiba | Kérj új döntést ahelyett, hogy némán megváltoztatnád a jóváhagyott közönséget. |
Nincs jóváhagyási pillanatkép, és a származtatott közönség nem érhető el | Engedélyezett tartalék (fallback) közönség | A hiányzó jóváhagyási adat nem aktiválja a szigorú újrajóváhagyási ágat. |
A kifejezetten kiválasztott közönség nem engedélyezett | Megfelelőségi (compliance) hiba | Frissítsd az elérhető választási lehetőségeket, és javítsd a kérést. |
Márkázott tartalom (branded content) privát láthatósággal kombinálva | Megfelelőségi (compliance) hiba | Oldd fel a reklámjelölés és a privát láthatóság ütközését még a posztolás előtt. |
Ezek a 2026-10-17-én futtatott helyi implementációs ellenőrzések eredményei: a meglévő megfelelőségi tesztcsomag 54 sikeres ellenőrzéssel és 0 hibával futott le. Ezek a tesztek a belső szabálylogikát igazolják, nem pedig éles TikTok-feltöltések megfigyelései. Ugyanez a tesztcsomag ellenőrizte azt is, hogy az időközben szigorított interakciós tiltások megmaradnak.
Válassz átviteli módot, és őrizd meg a művelet azonosítóját
A 2026-10-17-én ellenőrzött Direct Post referencia két átviteli módot támogat: a FILE_UPLOAD és a PULL_FROM_URL lehetőséget. Az első egy feltöltési célcímet ad vissza, ahová a videó bájtjait kell elküldeni. A második lehetővé teszi, hogy a TikTok maga töltse le a videót egy nyilvánosan elérhető média-URL-ről, ehhez azonban a TikTok megköveteli a domain vagy az URL-prefix igazolt tulajdonjogát. Egy olyan URL, amely a saját böngésződben hibátlanul megnyílik, még elbukhat ezen a domain-ellenőrzési követelményen.
A vizsgált feltöltőmodul különbséget tesz a két inicializálási művelet között az újrapróbálkozási (retry) döntéseknél. Mivel PULL_FROM_URL esetén a TikTok már az inicializálás után elkezdheti a média letöltését, egy elveszett hálózati válasz esetén a közzététel már folyamatban lehet a háttérben. Ha ilyenkor vakon megismétled az inicializálást, azzal egy második, duplikált posztot indíthatsz el — ezért az implementáció ezt a bizonytalan helyzetet eltérően kezeli attól a FILE_UPLOAD inicializálástól, amelyhez még egyetlen videóbájtot sem küldtünk fel.
A feltöltő továbbítja a brand_content_toggle, a brand_organic_toggle és az is_aigc mezőket a feloldott beállításokból. A borítókép kiválasztásához a dokumentált videóképkocka-időbélyeget (video_cover_timestamp_ms) használja, nem pedig különálló képfeltöltést. Ezeket a mezőleképezéseket 2026-10-17-én ellenőriztük a forráskódban; a cikkhez nem végeztünk új éles kézbesítési tesztet.
Kövesd végig a feldolgozást a valódi végállapotig
Mentsd el a visszaadott publish_id azonosítót, és használd a 2026-10-17-én ellenőrzött Get Post Status referenciát. A feldolgozási állapotok folyamatban lévő munkát jeleznek. Direct Post esetén a PUBLISH_COMPLETE állapot azt jelenti, hogy a tartalom bekerült a fiókba, de önmagában nem jelenti azt, hogy minden közönség számára nyilvánosan látható is.
A TikTok státuszdokumentációja különválasztja a posztolás befejezését a nyilvános elérhetőségtől, és rögzíti, hogy a nyilvános posztazonosítók a nyilvános láthatóságtól és a moderációs jóváhagyástól függnek. Soha ne címkézz egy privátként létrejött eredményt nyilvánosan közzétett posztként. A feladatkezelő implementációnk képes „platformra várakozó” állapotot fenntartani, és a médiaátvitel után külön státuszlekérdezőt (poller) használni ahelyett, hogy a fájlátvitel végét a végső közzététellel azonosítaná.
Ha az eredmény bizonytalan, újabb publikálás indítása előtt vizsgáld meg a meglévő műveletet és a célfiókot. Ha viszont a TikTok kifejezett elutasítással jelzi a jogosultsági, média- vagy láthatósági hibát, javítsd ki magát a kiváltó okot ahelyett, hogy változatlan formában küldenéd újra a kérést.
Mit ellenőrizz, mielőtt élesben támaszkodsz az integrációra?
Használd a videó-specifikáció ellenőrző eszközt a médiafájlok előzetes vizsgálatára, az AI-jelölés ellenőrzőt pedig a mesterséges intelligenciával készült tartalmak címkézési szabályainak áttekintésére. Ezek a segédeszközök nem helyettesítik az alkotó aktuális API-limitjeinek lekérdezését, a kifejezett felhasználói hozzájárulást vagy az éles fiókellenőrzést.
A saját átvételi teszted során jegyezd fel a célfiókot, a visszaadott láthatósági opciókat, a kiválasztott beállításokat, a műveletazonosítót (publish_id) és a végső kimenetelt. Ellenőrizd, hogy ha egy fiókkorlátozás az ütemezés után megváltozik, a rendszer megfelelően kér-e felhasználói beavatkozást. Kezeld külön a helyi szabályvalidációs teszteket és az éles posztolási tesztet: ez a cikk az előbbit és a forráskód-elemzést végezte el, míg az éles tokenek, az auditkonzol, a tényleges fájlfeltöltés és a felhasználói felületi kattintások ellenőrzése kívül esett a vizsgálat hatókörén.
Források és módszertan
Módszertan: a hivatalos dokumentáció és a saját implementáció ellenőrzése 2026-10-17-én. Az elsődleges termékbizonyíték az Uplonic TikTok-feltöltője, publikálója, megfelelőségi feloldója, újrapróbálkozási szabályzata és státuszlekérdezője. A helyi megfelelőségi tesztcsomag mind az 54 ellenőrzésen átment éles publikálási hívások nélkül. Versenytársak szövegeit vagy nem tesztelt végrehajtható API-példákat nem használtunk.
- TikTok Content Sharing Guidelines — ellenőrizve: 2026-10-17; auditálási korlátozások, kötelező felhasználói választások és hozzájárulás.
- TikTok Query Creator Info — ellenőrizve: 2026-10-17; futásidejű fiókkorlátok és a tokenenkénti 20 kérés/perc limit.
- TikTok Direct Post — ellenőrizve: 2026-10-17; jogosultsági kör (scope), átviteli módok, metaadatmezők és a tokenenkénti 6 kérés/perc inicializálási limit.
- TikTok Get Post Status — ellenőrizve: 2026-10-17; a feltöltés befejezése kontra nyilvános elérhetőség, valamint a tokenenkénti 30 kérés/perc státuszlimit.
