Miksi TikTok API -yhteys lakkaa toimimasta ja miten se pidetään toimivana
TikTok API for Business -yhteys lakkaa toimimasta, kun sen 24 tunnin käyttötoken jää uusimatta, sen vuoden päivitystoken päättyy, tilin omistaja poistaa sovelluksen käyttöoikeuden tai lähetetty token puuttuu tai on väärä. TikTok ilmoittaa tokenvirheet koodeilla 40102, 40103, 40104 ja 40105. Uusiminen ajoissa, tilien tarkistaminen aikataulussa ja omistajan pyytäminen valtuuttamaan uudelleen ennen vuoden loppua pitävät yhteyden toimivana.
easyCoexistence pitää jokaisen TikTok-yhteyden toimivana itsenäisesti: se uusii 24 tunnin tokenin ajoissa, tarkistaa tilin noin 6 tunnin välein ja kun TikTok hylkää tokenin, se merkitsee kanavan tilaan Uudelleenyhdistys tarvitaan ja lähettää sinulle sähköpostin Claudeen, ChatGPT:hen tai omaan alustaasi.
TikTok-tilin käyttötokenin elinikä API for Businessissa; /tt_user/oauth2/refresh_token/ uusii sen.
Päivitystokenin elinikä; kun se vanhenee, tilin omistajan on valtuutettava sovellus uudelleen.
Virheen syy, kun tilin omistaja poistaa sovelluksen käyttöoikeuden TikTokin käsitellessä julkaisua; TikTok kehottaa olemaan yrittämättä uudelleen.
Tapahtumat, joita TikTok lakkaa lähettämästä tilistä, kun omistajan valtuutus vanhenee tai peruutetaan.
Miksi TikTok for Developersin authorization.removed-tapahtuma käynnistyy: käyttäjä irrottaa yhteyden, tili poistetaan, ikä muuttuu, tili estetään tai kehittäjä peruuttaa valtuutuksen.
Kuinka usein easyCoexistence tarkistaa jokaisen yhdistetyn TikTok-tilin; se uusii 24 tunnin tokenin itsenäisesti ja lähettää sinulle sähköpostin, jos yhteys on yhdistettävä uudelleen.
Miksi TikTok API -yhteys lakkaa toimimasta?
Syitä on muutama, ja useimmat liittyvät tilin tokeneihin tai omistajan suostumukseen. Osa katkaisee yhteyden kokonaan, kun taas osa jättää sen puolitoimivaksi: osa kutsuista hylätään ja loput vastaavat yhä:
Mikä virhe kukin syy palauttaa ja mikä sen korjaa?
TikTokin code-kenttä nimeää useimmat, ja ne tulevat HTTP 200 -vastauksen sisällä eikä virhestatuksena. Julkaisun tila lisää oman epäonnistumissyynsä. Taulukossa on myös 40100, koska rajoitettu kutsu voi näyttää menetetyltä yhteydeltä. Kunkin merkitys ja korjaus:
| 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 |
Kuinka pitkään tokenit kestävät ja milloin ne pitää uusia?
API for Businessissa käyttötoken on voimassa 24 tuntia, ja jokaisen tokenvastauksen expires_in kertoo jäljellä olevat sekunnit. Päivitystoken on voimassa vuoden, ja sen oma laskuri on kentässä refresh_token_expires_in. Uudista hyvissä ajoin ennen päivän loppua aikataulun mukaan, älä vasta epäonnistuneen kutsun jälkeen. Tallenna jokaisen uusimisen palauttama päivitystoken, sillä TikTokin ohjeen mukaan kenttä on säilytettävä. Käsittele refresh_token_expires_in määräaikana: TikTokin uusimisesimerkissä laskuri vain laskee eikä aloita uutta vuotta.
Mitä tapahtuu, kun omistaja poistaa sovelluksen käyttöoikeuden?
Sovellus menettää Accounts API -oikeudet, jotka omistaja antoi, joten kutsut sillä tokenilla lakkaavat toimimasta. TikTok ei dokumentoi API for Business -tapahtumaa, joka ilmoittaisi tästä. Omistaja voi tehdä sen milloin tahansa TikTok-sovelluksessa kohdassa Asetukset ja yksityisyys, Turvallisuus, Hallitse sovellusten oikeuksia, Poista käyttöoikeus. Merkit näkyvät muualla: TikTokin käsittelemä julkaisu epäonnistuu tilalla auth_removed, johon TikTok kehottaa olemaan yrittämättä uudelleen, ja tilin comment.update-tapahtumat lakkaavat saapumasta.
Mitä tilityypin muutos tekee yhteydelle?
TikTok ei liitä tähän mitään tokenvirhettä dokumenteissaan. Muuttuu vain se, mitä API palauttaa. Tiedot, kuten unique_video_views, daily_new_followers ja audience_activity, vaativat Advanced Accessin tai vahvistetun yritystilin, samoin Mentions- ja Business Messaging -rajapinnat. Yksityisen tilin privacy_level_options jättää pois arvon PUBLIC_TO_EVERYONE. 16. lokakuuta 2026 jälkeen is_business_account on tosi vain vahvistetuille yritystileille ja has_advanced_access kertoo Advanced Accessin. Kun luet molemmat user.account.type-kentän alla, näet muutoksen ennen kuin kutsu kompastuu siihen.
Miten huomaat kuolleen yhteyden ennen asiakasta?
Tarkistuksilla, jotka toimivat riippumatta siitä, julkaiseeko kukaan:
- Kevyt kutsu jokaiselle tilille aikataulussa, esimerkiksi /business/get/ kentillä username, joka palauttaa tokenvirheen, kun token lakkaa toimimasta.
- /
tt_user/token_info/get/, joka ei vaadi oikeuksia ja palauttaa tokenin scope-arvon, jolla varmistat, että myönnetyt oikeudet kattavat ominaisuuksiesi kutsut. refresh_token_expires_inmuutettuna päivämääräksi jokaisen vastauksen saapuessa, ja muistutus omistajalle viikkoja ennen sitä.- Hiljaisuus comment.update-tapahtumissa tilille, joka yleensä saa kommentteja, koska TikTok lopettaa nämä tapahtumat, kun valtuutus vanhenee tai peruutetaan.
- 40102, 40103, 40104 ja 40105 lasketaan tilikohtaisesti, jotta yksi epäonnistuva tili erottuu monien joukosta.
Miten yhdistät tilin uudelleen?
Ajamalla valtuutuksen uudelleen samalle tilille. Jaa TikTok-tilin haltijan valtuutus-URL, jossa on state-arvo, joka sitoo paluun tiliin, ja disable_auto_auth=1, jos omistajan pitää nähdä oikeussivu uudelleen. Vaihda uusi auth_code /tt_user/oauth2/token/-rajapinnassa sen 10 minuutin sisällä ja korvaa molemmat tallennetut tokenit. open_id on TikTokin sovelluskohtainen tilin tunnus, joten sovita uudet tokenit tallennettuun tietueeseen sen perusteella eikä luo toista.
Vanhenevatko Content Posting API -yhteydet samalla tavalla?
Eivät. TikTok for Developers, joka tarjoaa Content Posting- ja Display-rajapinnat, päivitti tokensivunsa 2. marraskuuta 2026: käyttäjän käyttötokenit vanhenevat 2 tunnin kuluessa ja päivitystokenit ovat voimassa 180 päivää ensimmäisestä myöntämisestä. Päivitystokenit kiertävät, joten jokainen onnistunut päivitys palauttaa uuden ja mitätöi heti lähetetyn. Jos palvelin käyttää korvattua tokenia, myöhemmät päivitykset epäonnistuvat ja käyttäjän on valtuutettava uudelleen. Virheellinen päivitystoken epäonnistuu virheellä invalid_grant, virheellinen käyttötoken virheellä access_token_invalid ja HTTP 401. Sen authorization.removed-webhook kertoo, miksi käyttäjä lähti.
Mitä easyCoexistence tekee TikTok-yhteyden pitämiseksi toimivana?
Se uusii ja tarkistaa yhteyden itsenäisesti ja kertoo, kun vain omistaja voi korjata sen:
- Uusiminen: ennen kutsua, kun jäljellä on alle 15 minuuttia, ja tarkistuksen aikana, kun jäljellä on alle 8 tuntia. Uusi päivitystoken ja sen vanhenemisaika tallennetaan joka kerta.
- Yksi uusiminen kerrallaan tiliä kohden, joten samanaikaiset kutsut jakavat sen.
- Tarkistus: /business/get/-kutsu tilin username-arvolla noin 6 tunnin välein.
- Hylätty token, 40102, 40104 tai 40105: kanava merkitään tilaan Uudelleenyhdistys tarvitaan, omistaja saa yhden sähköpostin ja alusta saa channel.disconnected-tapahtuman, jossa TikTokin viesti on
disconnected_reason-kentässä. - Siihen asti työkalut vastaavat, että tili on yhdistettävä uudelleen, ja ajastettu julkaisu epäonnistuu tilaan ”reconnect” sen sijaan, että se menisi TikTokiin.
- Uudelleenyhdistäminen: Yhdistä TikTok kanavan sivulla tai uusi yhdistämisistunto kirjautuu uudelleen sisään ja säilyttää saman
account_id-tunnuksen ja tapahtumien kohteen.
Näin otat sen käyttöön
- 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.
Yleiset virheet
- Hiljainen kommentti-webhook tulkitaan hiljaiseksi tiliksi. TikTok lopettaa comment.update-tapahtumat tililtä, kun sen valtuutus päättyy, joten tarkista tili sen sijaan, että odotat tapahtumia.
- Yhdistäminen uuteen tietueeseen. Sovita uudet tokenit open_id-kentän perusteella, TikTokin sovelluskohtaisen tilitunnuksen, ja päivitä tallennettu tietue paikallaan, säilyttäen sen historia ja asetukset.
- 40103 tai 40107 uudelleenyrittäminen samalla päivitystokenilla. Kumpikaan ei korjaannu uudella yrityksellä: ensimmäinen vaatii uuden valtuutuksen, toinen viimeisimmän vastauksen päivitystokenin tai uuden valtuutuksen.
- 40100:n tulkitseminen menetetyksi yhteydeksi. Se on rajoitettu kutsu. Keskeytä päätepiste 5 minuutiksi tai päivärajan jälkeen klo 00:00 UTC asti, niin sama token toimii yhä.
US$ 9 per yhteys kuukaudessa, laskien US$ 0,75:een yhteyksien määrän kasvaessa, ensimmäiset 3 päivää ilmaiseksi.
Usein kysytyt kysymykset
Voiko TikTok API -yhteys kestää ilman omistajaa ikuisesti?
Ei. Uusiminen kantaa yhteyden enintään päivitystokenin vuoden yli. Sen jälkeen TikTokin dokumentoitu polku on tilin omistajan uusi valtuutus.
Miksi TikTok-yhteydet epäonnistuivat useammalla tilillä kerralla?
Katso ensin sovellus, ennen tilejä: 40113 tarkoittaa, että sovellus on estetty tai sen tunnus ja salaisuus eivät täsmää. TikTok voi myös peruuttaa sovelluksen Accounts API -käyttöoikeuden väärinkäytön vuoksi.
Tarkoittaako uusi ominaisuus TikTok-tilien yhdistämistä uudelleen?
Kyllä, jos se tarvitsee oikeuden, jonka omistaja ei koskaan myöntänyt. Token säilyttää valtuutuksessa hyväksytyt oikeudet, joten omistajan täytyy valtuuttaa sovellus uudelleen lisätäkseen yhden.
Mitä ajastetuille TikTok-julkaisuille tapahtuu, kun tili pitää yhdistää uudelleen?
easyCoexistencessä ne epäonnistuvat niiden ajankohtana tilaan ”reconnect” sen sijaan, että ne menisivät TikTokiin. Omistajalle lähetetään sähköposti, ja Yritä uudelleen lähettää ne, kun tili on taas yhdistetty.
Lue lisää
Yhdistä ensimmäinen kanavasi kahdessa minuutissa.
Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.
- 3 päivää ilmaiseksi
- Peruuta milloin tahansa
- Vain viralliset API:t
- Valvottu 24/7
Vahvistettu