TikTok-virhe 40102: access token on vanhentunut
TikTok-virhe 40102 tarkoittaa, että pyynnön mukana lähetetty access token on vanhentunut, ja pyyntö täytyy lähettää uusimmalla tokenilla. Accounts API:n access token on voimassa yhden päivän. Uusi se lähettämällä refresh token osoitteeseen /tt_user/oauth2/refresh_token/ ja toista kutsu. Refresh token on voimassa yhden vuoden, minkä jälkeen tilin omistaja valtuuttaa sovelluksen uudelleen.
easyCoexistence uusii 24 tunnin TikTok-tokenin itsenäisesti refresh tokenilla ennen vanhenemista, joten Claude-, ChatGPT- tai omat kutsusi lähtevät aina voimassa olevalla tokenilla.
TikTokin paluukoodi vanhentuneelle access tokenille; kutsu on tehtävä uusimmalla tokenilla.
Kuinka kauan Accounts API:n TikTok-tilin access token pysyy voimassa.
expires_in-arvo sekunteina TikTokin esimerkissä uudelle access tokenille.
Kuinka kauan refresh token pysyy voimassa; sen vanhennuttua omistajan on valtuutettava sovellus uudelleen.
Mitä virhe 40102 tarkoittaa?
Access-Token-otsakkeessa oleva access token on ylittänyt voimassaoloaikansa. TikTokin paluukoodiliitteessä 40102 on merkitty vanhentuneeksi access tokeniksi, ja sen mukaan kutsu on tehtävä uusimmalla tokenilla. Korjaus on käyttää voimassa olevaa access tokenia ja yrittää uudelleen.
Koodi tulee vastauksen rungossa. Useimmat TikTokin API for Business -rajapinnan kutsut palauttavat HTTP 200 -tilan, ja se, onnistuiko kutsu, kertoo paluukoodi eikä tila.
Kuinka kauan TikTok-access token on voimassa?
Yhden päivän API for Business -rajapinnassa. Accounts API antaa TikTok-tilin access tokenin, kun sovellus vaihtaa valtuutuskoodin osoitteessa /tt_user/oauth2/token/. Vastaus kertoo voimassaoloajan kentässä expires_in, TikTokin esimerkissä 86 400 sekuntia. Samassa vastauksessa on refresh token, joka on voimassa yhden vuoden ja jonka TikTok neuvoo säilyttämään access tokenin uusimista varten. TikTok for Developersin käyttäjätason access tokenit, joita Content Posting API käyttää, ovat sen sijaan voimassa 2 tuntia.
Miten se uusitaan?
Lähetä refresh token osoitteeseen /tt_user/oauth2/refresh_token/ sovelluksen ID:n ja salaisuuden kanssa, ja grant_type-arvoksi refresh_token. Vastauksessa on uusi access token ja uusi refresh token: tallenna molemmat, lähetä sen jälkeen uusi access token Access-Token-otsakkeessa ja toista epäonnistunut kutsu. Uusiminen ennen päivän loppua estää kutsuja osumasta TikTokiin vanhentuneella tokenilla lainkaan.
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/oauth2/refresh_token/' \
-H 'Content-Type: application/json' \
-d '{
"client_id": "<APP_ID>",
"client_secret": "<SECRET>",
"grant_type": "refresh_token",
"refresh_token": "<REFRESH_TOKEN>"
}'
# data: access_token, expires_in (86400), refresh_token, refresh_token_expires_inMilloin omistajan täytyy valtuuttaa uudelleen?
Kun uusiminen ei enää onnistu. Refresh token on voimassa yhden vuoden, ja TikTokin dokumentaation mukaan sen vanhennuttua kehittäjä pyytää tilin omistajaa valtuuttamaan sovelluksen uudelleen valtuutusprosessin kautta. Omistaja voi myös peruuttaa valtuutuksen milloin tahansa TikTok-sovelluksesta kohdasta Asetukset ja yksityisyys, Turvallisuus, Hallitse sovelluksen käyttöoikeuksia. Tällöin uusi valtuutus on ainoa tie takaisin.
Yleiset virheet
- Uusiminen vasta kun kutsu epäonnistuu. Päivän kestävä token vanhenee joka päivä, joten uusi se etukäteen ja estä kutsuja osumasta TikTokiin vanhalla tokenilla.
- Refresh tokenin jättäminen huomiotta uusimisvastauksessa. TikTokin ohjeen mukaan se säilytetään seuraavaa uusimista varten, joten tallenna jokaisen uusimisen palauttama.
- Pelkän HTTP-tilan tarkistaminen. TikTok vastaa yleensä HTTP 200 ja laittaa 40102 koodikenttään, joten pelkkä tilatarkistus merkitsee virheen onnistuneeksi.
- Tokenin kopioiden säilyttäminen useassa paikassa. Yhden kopion uusiminen jättää muut vanhenemaan ja epäonnistumaan virheellä 40102.
Jos TikTok hylkää tokenin silti virhekoodilla 40102, 40104 tai 40105, yhteys merkitään heti uudelleenyhdistettäväksi ja saat sähköpostin. Oma koodisi voi hakea ajantasaisen tokenin get_social_credentials-funktiosta, eikä sen tarvitse säilyttää kopiota. Hinta laskee US$ 9:stä US$ 0,75:een yhteyttä kohden kuukaudessa, kun yhteyksiä lisää, ja ensimmäiset 3 päivää ovat ilmaisia.
Usein kysytyt kysymykset
Mitä expires_in tarkoittaa TikTokin tokenivastauksessa?
Se on sekuntimäärä, jonka access token on voimassa ennen vanhenemista: TikTokin esimerkissä uudessa Accounts API:n tokenissa 86 400, eli yksi päivä. Lisää se vastauksen ajanhetkeen, niin tiedät milloin uusia, ennen virhettä 40102.
Voiko vanhentuneen TikTok access tokenin uusia?
Kyllä, niin kauan kuin refresh token on voimassa. Lähetä se osoitteeseen /tt_user/oauth2/refresh_token/, ja TikTok palauttaa uuden access tokenin ja refresh tokenin.
Tarkoittaako virhe 40102, että tili täytyy yhdistää uudelleen?
Ei sinänsä. Voimassa oleva refresh token uusii pääsyn ilman omistajaa. Uusi valtuutus tarvitaan vain, kun refresh token on vanhentunut tai omistaja on peruuttanut pääsyn.
Miksi HTTP 200 -vastauksessa on virhe 40102?
TikTokin paluukoodit menevät HTTP-tilan edelle. Kutsu onnistui vain, jos sen koodi on 0, mitä tilarivi sitten sanookaan.
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