De ce nu mai funcționează o conexiune TikTok API și cum o mențineți activă
O conexiune TikTok API for Business încetează să funcționeze atunci când token-ul ei de acces de 24 de ore nu este reînnoit, când token-ul de reîmprospătare de un an expiră, când proprietarul elimină accesul aplicației sau când token-ul trimis lipsește ori este greșit. TikTok raportează cazurile de token ca 40102, 40103, 40104 și 40105. Reînnoirea din timp, verificarea fiecărui cont după un program și rugarea proprietarului să autorizeze din nou înainte de sfârșitul anului o mențin activă.
easyCoexistence păstrează fiecare conexiune TikTok activă singur: reînnoiește token-ul de 24 de ore din timp, verifică contul aproximativ la fiecare 6 ore și, când TikTok refuză token-ul, marchează canalul ca „necesită reconectare” și vă trimite un e-mail, pentru Claude, ChatGPT sau propria platformă.
Durata token-ului de acces al unui cont TikTok din API for Business; /tt_user/oauth2/refresh_token/ îl reînnoiește.
Durata token-ului de reîmprospătare; odată expirat, proprietarul contului trebuie să autorizeze din nou aplicația.
Motivul eșecului când proprietarul elimină accesul aplicației în timp ce TikTok procesează o postare; TikTok spune să nu fie reîncercată.
Evenimentele pe care TikTok încetează să le mai trimită pentru un cont, după ce autorizarea proprietarului expiră sau este revocată.
De ce se declanșează authorization.removed din TikTok for Developers: utilizatorul se deconectează, contul este șters, se schimbă vârsta, există o suspendare sau dezvoltatorul revocă accesul.
Cât de des verifică easyCoexistence fiecare cont TikTok conectat; reînnoiește singur token-ul de 24 de ore și vă trimite un e-mail dacă este nevoie de reconectare.
De ce se oprește o conexiune TikTok API?
Din câteva motive, majoritatea legate de token-urile contului sau de consimțământul proprietarului. Unele opresc conexiunea complet, iar altele o lasă pe jumătate funcțională, cu unele apeluri refuzate și restul încă răspunzând:
Ce eroare returnează fiecare cauză și ce o remediază?
Câmpul code al TikTok denumește majoritatea, într-un răspuns HTTP 200 și nu cu un cod de stare de eroare, iar starea publicării adaugă un motiv de eșec propriu. 40100 apare în tabel deoarece un apel limitat poate părea o conexiune pierdută. Ce înseamnă fiecare și remedierea:
| 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 |
Cât durează token-urile și când trebuie să le reînnoiți?
În API for Business, token-ul de acces durează 24 de ore, iar expires_in din fiecare răspuns de token indică secundele rămase; token-ul de reîmprospătare durează un an, cu propriul contor în refresh_token_expires_in. Reînnoiți cu mult înainte de sfârșitul zilei, după un program și nu după un apel eșuat, și stocați token-ul de reîmprospătare returnat la fiecare reînnoire, deoarece TikTok recomandă să-l păstrați. Tratați refresh_token_expires_in ca pe un termen limită: în exemplul de reînnoire al TikTok, acesta numără în jos în loc să înceapă un nou an.
Ce se întâmplă când proprietarul elimină accesul aplicației?
Aplicația pierde permisiunile Accounts API acordate de proprietar, deci apelurile cu acel token încetează să funcționeze, iar TikTok nu documentează niciun eveniment API for Business care să anunțe asta. Proprietarul poate face acest lucru oricând în aplicația TikTok, la „Settings and privacy”, „Security”, „Manage app permissions”, „Remove access”. Semnele apar în altă parte: o postare pe care TikTok o procesa eșuează cu auth_removed, iar TikTok spune să nu fie reîncercată, iar evenimentele comment.update pentru cont încetează să mai sosească.
Ce face schimbarea tipului de cont conexiunii?
TikTok nu asociază nicio eroare de token cu aceasta în documentația sa; ce se schimbă este ce returnează API-ul. Datele precum unique_video_views, daily_new_followers și audience_activity necesită Advanced Access sau un Verified Business Account, la fel ca API-urile Mentions și Business Messaging, iar privacy_level_options al unui cont privat exclude PUBLIC_TO_EVERYONE. Din 16 octombrie 2026, is_business_account are valoarea true doar pentru Verified Business Accounts, iar has_advanced_access indică Advanced Access, așa că citirea ambelor, sub user.account.type, arată o schimbare înainte ca un apel să se blocheze.
Cum detectați o conexiune moartă înainte ca un client s-o facă?
Cu verificări care rulează indiferent dacă cineva postează:
- Un apel ușor pe cont, după un program, cum ar fi /business/get/ cu câmpul username, care returnează o eroare de token imediat ce token-ul încetează să funcționeze.
- /
tt_user/token_info/get/, care nu necesită permisiune și returnează scope-ul token-ului, pentru a confirma că permisiunile acordate mai acoperă ceea ce apelează funcțiile dumneavoastră. refresh_token_expires_intransformat într-o dată la fiecare răspuns primit, cu un memento pentru proprietar cu săptămâni înainte.- Tăcere pe comment.update pentru un cont care de obicei primește comentarii, deoarece TikTok oprește aceste evenimente după ce autorizarea expiră sau este revocată.
- 40102, 40103, 40104 și 40105 numărate pe cont, astfel încât un cont care eșuează să se remarce printre multe.
Cum reconectați un cont?
Rulând din nou autorizarea pentru același cont. Trimiteți URL-ul de autorizare al titularului contului TikTok, cu o valoare state care leagă revenirea de cont, și disable_auto_auth=1 dacă proprietarul trebuie să vadă din nou pagina de permisiuni. Schimbați noul auth_code la /tt_user/oauth2/token/ în cele 10 minute, apoi înlocuiți ambele token-uri stocate. open_id este ID-ul specific aplicației al TikTok pentru cont, așa că potriviți noile token-uri cu înregistrarea stocată după acesta, în loc să creați una a doua.
Conexiunile Content Posting API expiră în același mod?
Nu. TikTok for Developers, care servește API-urile Content Posting și Display, și-a actualizat paginile despre token-uri pe 2 noiembrie 2026: token-urile de acces ale utilizatorului expiră în 2 ore, iar token-urile de reîmprospătare durează 180 de zile de la prima emitere. Token-urile de reîmprospătare ale acestuia se rotesc, deci fiecare reîmprospătare reușită returnează unul nou și invalidează imediat cel trimis; dacă un server continuă să folosească un token înlocuit, reîmprospătările ulterioare eșuează și utilizatorul trebuie să autorizeze din nou. Un token de reîmprospătare invalid eșuează cu invalid_grant, un token de acces invalid cu access_token_invalid și HTTP 401, iar webhook-ul său authorization.removed spune de ce a plecat un utilizator.
Ce face easyCoexistence ca o conexiune TikTok să rămână activă?
Reînnoiește și verifică singur și vă spune când doar proprietarul poate remedia situația:
- Reînnoire: înainte de un apel, când mai sunt mai puțin de 15 minute, și în timpul unei verificări, când mai sunt mai puțin de 8 ore, stocând de fiecare dată noul token de reîmprospătare și data sa de expirare.
- O singură reînnoire pe cont la un moment dat, astfel încât apelurile care sosesc împreună o împart.
- Verificarea: un apel /business/get/ pentru username-ul contului, aproximativ la fiecare 6 ore.
- Un token refuzat, 40102, 40104 sau 40105: canalul afișează „necesită reconectare”, proprietarul primește un singur e-mail, iar o platformă primește channel.disconnected, cu mesajul TikTok ca
disconnected_reason. - Până atunci, instrumentele răspund că339 contul trebuie reconectat, iar o postare programată eșuează cu motivul „reconectare” în loc să ajungă la TikTok.
- Reconectare: Conectați TikTok pe pagina canalului sau o nouă sesiune de conectare, care autentifică din nou și păstrează același
account_idși aceeași destinație pentru evenimente.
Cum să îl configurați
- 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.
Greșeli frecvente
- Tratarea unui webhook de comentarii tăcut drept un cont tăcut. TikTok oprește comment.update pentru un cont imediat ce autorizarea sa se încheie, așa că verificați contul în loc să așteptați evenimentele.
- Reconectarea într-o înregistrare nouă. Potriviți noile token-uri după open_id, ID-ul specific aplicației al TikTok pentru cont, și actualizați înregistrarea stocată pe loc, păstrându-i istoricul și setările.
- Reîncercarea lui 40103 sau 40107 cu același token de reîmprospătare. Niciunul nu se rezolvă prin reîncercare: primul necesită o autorizare nouă, iar al doilea, token-ul de reîmprospătare din ultimul răspuns sau o autorizare nouă.
- Citirea lui 40100 drept o conexiune pierdută. Este un apel limitat; suspendați endpoint-ul 5 minute sau până la 00:00 UTC după o limită zilnică, iar același token continuă să funcționeze.
De la US$ 9 până la US$ 0.75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu prima perioadă de probă gratuită de 3 zile.
Întrebări frecvente
Poate o conexiune TikTok API să dureze la nesfârșit fără proprietar?
Nu. Reînnoirea o duce cel mult prin anul token-ului de reîmprospătare; după aceea, calea documentată de TikTok este o autorizare nouă din partea proprietarului contului.
De ce au eșuat conexiunile TikTok pentru mai multe conturi deodată?
Uitați-vă mai întâi la aplicație, înainte de conturi: 40113 înseamnă că aplicația este blocată sau că ID-ul și secretul ei nu se potrivesc, iar TikTok poate revoca accesul unei aplicații la Accounts API pentru utilizare abuzivă.
O funcționalitate nouă înseamnă reconectarea conturilor TikTok?
Când necesită un scope pe care proprietarul nu l-a acordat niciodată, da. Un token păstrează scope-urile aprobate la autorizare, deci proprietarul autorizează din nou aplicația ca să adauge unul.
Ce se întâmplă cu postările TikTok programate cât timp un cont trebuie reconectat?
Pe easyCoexistence, acestea eșuează cu motivul „reconectare” la ora programată, în loc să ajungă la TikTok, proprietarul primește un e-mail, iar butonul „Reîncearcă” le trimite din nou după ce contul este reconectat.
Continuați să citiți
Conectați primul canal în două minute.
Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.
- 3 zile gratuit
- Anulați oricând
- Doar API-uri oficiale
- Monitorizat 24/7
Verificat la