Zašto TikTok API veza prestaje raditi i kako je održati aktivnom
Veza s TikTok API for Business prestaje raditi kad se njezin pristupni token od 24 sata ne obnovi, kad istekne njezin token za osvježavanje od godinu dana, kad vlasnik ukloni pristup aplikaciji ili kad poslani token nedostaje ili je neispravan. TikTok te slučajeve tokena prijavljuje kodovima 40102, 40103, 40104 i 40105. Ranije obnavljanje, provjera svakog računa prema rasporedu i traženje od vlasnika da ponovno odobri pristup prije isteka godine održavaju vezu aktivnom.
easyCoexistence održava svaku TikTok vezu aktivnom sam: obnavlja 24-satni token unaprijed, provjerava račun otprilike svakih 6 sati i kad TikTok odbije token, označava kanal kao Potrebno ponovno povezivanje i šalje vam e-poštu, za Claude, ChatGPT ili vašu vlastitu platformu.
Trajanje pristupnog tokena računa TikTok na API for Business; /tt_user/oauth2/refresh_token/ ga obnavlja.
Trajanje tokena za osvježavanje; nakon isteka vlasnik računa mora ponovno odobriti aplikaciju.
Razlog neuspjeha kad vlasnik ukloni pristup aplikaciji dok TikTok obrađuje objavu; TikTok kaže da se ne ponavlja.
Događaji koje TikTok prestaje slati za račun kad istekne ili bude opozvano vlasnikovo odobrenje.
Zašto se u TikTok for Developers aktivira authorization.removed: korisnik se odjavi, račun se izbriše, dođe do promjene dobi, uslijedi zabrana ili razvijatelj opozove pristup.
Koliko često easyCoexistence provjerava svaki povezani TikTok račun; sam obnavlja 24-satni token i šalje vam e-poštu ako je potrebno ponovno povezivanje.
Zašto veza s TikTok API-jem prestaje raditi?
Iz nekoliko razloga, većinom vezanih uz tokene računa ili suglasnost vlasnika. Neki potpuno prekinu vezu, dok drugi ostave vezu polovično aktivnom, pa se neki pozivi odbijaju, a ostali i dalje odgovaraju:
Koji kôd pogreške vraća svaki uzrok i što ga popravlja?
Polje code u TikTok odgovoru imenuje većinu njih unutar HTTP 200 odgovora, a ne statusa pogreške, dok status objave dodaje vlastiti razlog neuspjeha. Kôd 40100 je u tablici jer ograničen poziv može izgledati kao izgubljena veza. Što svaki znači i kako se popravlja:
| What it means | The fix | |
|---|---|---|
| 40102 | The access token is past its 24 hours | Renew with the refresh token, store both new tokens, repeat the call |
| 40103 | The refresh token has expired | A new authorization by the owner; nothing renews it |
| 40104 | The request carried no access token | A bug in the request: send the Access-Token header |
| 40105 | The access token is invalid or incorrect | Check what was sent, renew, then ask the owner to authorize again |
| 40107 | The refresh token is invalid or incorrect | Send the refresh token from the latest response, or a new authorization |
| 40131 | Authentication failed at a token endpoint | Check the app ID and secret, then the code or the refresh token |
| 40001 | A permission or scope is missing | Add it to the app, then have the owner authorize again |
| auth_removed | Access was removed while a post was processing | No retry; publish again after a new authorization |
| 40100 | Throttled, not disconnected | Pause the endpoint 5 minutes; the token still works |
Koliko traju tokeni i kada ih treba obnoviti?
Na API for Business pristupni token traje 24 sata, a expires_in u svakom odgovoru s tokenom daje preostale sekunde; token za osvježavanje traje godinu dana, s vlastitim odbrojavanjem u refresh_token_expires_in. Obnavljajte dovoljno prije kraja dana, prema rasporedu, a ne nakon neuspjelog poziva, i spremite token za osvježavanje koji svako obnavljanje vraća, jer TikTok u napomeni za to polje kaže da ga treba zadržati. Refresh_token_expires_in tretirajte kao rok: u TikTokovu primjeru obnavljanja on odbrojava umjesto da počne novu godinu.
Što se događa kad vlasnik ukloni pristup aplikaciji?
Aplikacija gubi dopuštenja Accounts API koja joj je vlasnik dao, pa pozivi s tim tokenom prestaju raditi, a TikTok ne dokumentira događaj API for Business koji to najavljuje. Vlasnik to može učiniti u bilo kojem trenutku u aplikaciji TikTok, u izborniku Postavke i privatnost, Sigurnost, Upravljanje dopuštenjima aplikacije, Ukloni pristup. Znakovi se pojavljuju drugdje: objava koju je TikTok obrađivao ne uspijeva s auth_removed, što TikTok kaže da se ne ponavlja, a događaji comment.update za račun prestaju stizati.
Što promjena vrste računa čini s vezom?
TikTok u svojoj dokumentaciji ne vezuje uz to nijednu pogrešku tokena; mijenja se ono što API vraća. Podaci poput unique_video_views, daily_new_followers i audience_activity zahtijevaju Advanced Access ili Verified Business Account, kao i Mentions i Business Messaging API-ji, a privacy_level_options privatnog računa izostavlja PUBLIC_TO_EVERYONE. Od 16. listopada 2026. is_business_account je true samo za Verified Business Account, a has_advanced_access prijavljuje Advanced Access, pa čitanje oboje pod user.account.type pokazuje promjenu prije nego poziv na nju naiđe.
Kako uhvatiti mrtvu vezu prije nego to uoči kupac?
Provjerama koje rade bez obzira objavljuje li netko:
- Lagani poziv po računu prema rasporedu, npr. /business/get/ s poljem username, koji vraća token grešku čim token prestane raditi.
- /
tt_user/token_info/get/, koji ne traži dopuštenje i vraća opseg tokena, da potvrdite kako dopuštenja još pokrivaju ono što vaše značajke pozivaju. refresh_token_expires_inpretvoren u datum pri svakom odgovoru, uz podsjetnik vlasniku nekoliko tjedana prije.- Tišina na comment.update za račun koji inače dobiva komentare, jer TikTok prestaje slati te događaje kad istekne ili bude opozvano odobrenje.
- Brojanje 40102, 40103, 40104 i 40105 po računu, da se jedan neispravan račun istakne među mnogima.
Kako ponovno povezati račun?
Ponovnim pokretanjem odobrenja za isti račun. Podijelite URL za odobrenje vlasnika računa TikTok, s vrijednošću state koja povezuje povratak s računom, i disable_auto_auth=1 ako vlasnik treba ponovno vidjeti stranicu s dopuštenjima. Zamijenite novi auth_code na /tt_user/oauth2/token/ unutar njegovih 10 minuta, zatim zamijenite oba pohranjena tokena. open_id je TikTokov ID računa specifičan za aplikaciju, pa novi tokene uskladite s pohranjenim zapisom prema njemu umjesto da stvarate drugi.
Istječu li veze Content Posting API-ja na isti način?
Ne. TikTok for Developers, koji služi Content Posting i Display API-jima, 2. studenoga 2026. ažurirao je stranice o tokenima: korisnički pristupni tokeni istječu unutar 2 sata, a tokeni za osvježavanje traju 180 dana od prvog izdavanja. Tokeni za osvježavanje rotiraju, pa svako uspješno obnavljanje vraća novi i odmah poništava poslani, a ako poslužitelj nastavi koristiti zamijenjen token, kasnija obnavljanja ne uspijevaju i korisnik mora ponovno odobriti pristup. Loš token za osvježavanje ne uspijeva s invalid_grant, loš pristupni token s access_token_invalid i HTTP 401, a njegov webhook authorization.removed kaže zašto je korisnik otišao.
Što easyCoexistence čini da održi TikTok vezu aktivnom?
Sam je obnavlja i provjerava, a kaže vam kad to može popraviti samo vlasnik:
- Obnavljanje: prije poziva kad je preostalo manje od 15 minuta, a tijekom provjere kad je preostalo manje od 8 sati, uz pohranu novog tokena za osvježavanje i njegova isteka svaki put.
- Jedno obnavljanje u isto vrijeme po računu, pa pozivi koji stignu zajedno dijele jedno.
- Provjera: poziv /business/get/ za korisničko ime računa otprilike svakih 6 sati.
- Odbijen token, 40102, 40104 ili 40105: kanal prikazuje Potrebno ponovno povezivanje, vlasnik dobiva jednu e-poštu, a platforma prima channel.disconnected, s TikTokovom porukom kao
disconnected_reason. - Dok to ne bude riješeno, alati odgovaraju da račun treba ponovno povezati, a zakazana objava ne uspijeva s reconnect umjesto da stigne do TikToka.
- Ponovno povezivanje: Poveži TikTok na stranici kanala ili nova sesija povezivanja prijavljuje se ponovno i zadržava isti
account_idi odredište događaja.
Kako ga postaviti
- Store both tokens with datesSave access_token, refresh_token, open_id and scope, and turn expires_in and refresh_token_expires_in into dates as each response arrives.
- Renew ahead of the dayCall /tt_user/oauth2/refresh_token/ well before the 24 hours end, one renewal per account at a time, and keep the refresh token it returns.
- Check each accountMake one light call per account on a schedule and record any 40102, 40103, 40104 or 40105 against that account.
- Ask before the year endsSend the owner the authorization URL before refresh_token_expires_in runs out, and replace both tokens when the new code arrives.
- Reconnect on a token errorWhen renewal fails or the token is refused, stop calling for that account and send its owner the authorization URL.
Uobičajene pogreške
- Tretirati tihi webhook za komentare kao tihi račun. TikTok prestaje slati comment.update za račun kad se njegovo odobrenje završi, pa provjerite račun umjesto da čekate događaje.
- Ponovno povezivanje u novi zapis. Uskladite nove tokene prema open_id, TikTokovu ID-u računa specifičnom za aplikaciju, i ažurirajte pohranjeni zapis na mjestu, zadržavajući njegovu povijest i postavke.
- Ponavljanje 40103 ili 40107 istim tokenom za osvježavanje. Nijedan se ne otklanja ponavljanjem: prvi traži novo odobrenje, a drugi token za osvježavanje iz posljednjeg odgovora ili novo odobrenje.
- Čitanje 40100 kao izgubljene veze. To je ograničen poziv; pauzirajte endpoint 5 minuta ili do 00:00 UTC nakon dnevnog ograničenja, i isti token nastavlja raditi.
Od US$ 9 po vezi mjesečno, uz pad do US$ 0,75 kako dodajete veze, uz besplatno probno razdoblje od 3 dana.
Često postavljana pitanja
Može li veza TikTok API-ja trajati zauvijek bez vlasnika?
Ne. Obnavljanje održava vezu najviše do isteka godine tokena za osvježavanje; poslije toga TikTokov dokumentirani put je novo odobrenje vlasnika računa.
Zašto su TikTok veze pale za nekoliko računa istodobno?
Prvo pogledajte aplikaciju, pa tek onda račune: 40113 znači da je aplikacija blokirana ili da se njezin ID i tajna ne podudaraju, a TikTok može opozvati pristup aplikacije Accounts API zbog zlouporabe.
Znači li nova značajka ponovno povezivanje TikTok računa?
Kad je potreban opseg koji vlasnik nikad nije odobrio, da. Token zadržava opsege odobrene pri autorizaciji, pa vlasnik ponovno odobrava aplikaciju da dodate jedan.
Što se događa sa zakazanim TikTok objavama dok račun treba ponovno povezati?
U easyCoexistence zakazane objave ne uspijevaju s reconnect u svoje vrijeme umjesto da stignu do TikToka, vlasnik dobiva e-poštu, a Ponovi ih šalje čim je račun ponovno povezan.
Nastavite čitati
Povežite svoj prvi kanal u dvije minute.
Bez čekanja na provjere platformi. Povežite WhatsApp, Instagram, TikTok ili drugi kanal, zatim zamolite svoju umjetnu inteligenciju da objavi, odgovori ili izradi izvješće i gledajte kako radi.
- 3 dana besplatno
- Otkažite bilo kada
- Samo službeni API-ji
- Nadzor 24/7
Provjereno na