TikTok API for Business -access tokenit: 24 tuntia, uusiminen ja peruutus
TikTok API for Business -access tokenin elinikä on 24 tuntia, ja se kulkee Access-Token-otsikossa. Sovellus saa tokenin vaihtamalla tilin omistajan valtuutuskoodin osoitteessa /tt_user/oauth2/token/. Samalla se saa refresh tokenin, joka on voimassa vuoden ja uusii käyttöoikeuden osoitteessa /tt_user/oauth2/refresh_token/. Tokenin voi peruuttaa osoitteessa /tt_user/oauth2/revoke/, ja myönnetyt oikeudet voi listata osoitteessa /tt_user/token_info/get/.
easyCoexistence vaihtaa koodin, kun TikTok-tili kirjautuu sisään, uusii 24 tunnin tokenin ennen kuin se vanhenee ja tarkistaa tilin noin 6 tunnin välein.
Access tokenin elinikä; jokaisessa token-vastauksessa kerrotaan expires_in-kentässä jäljellä olevat sekunnit.
Sen kanssa myönnetyn refresh tokenin voimassaoloaika; refresh_token_expires_in antaa jäljellä olevat sekunnit.
Kuinka kauan uudelleenohjauksen valtuutuskoodi pysyy voimassa; sen voi vaihtaa vain kerran.
Tilin sovelluskohtainen tunniste, joka palautetaan jokaisen tokenin mukana ja lähetetään business_id-kenttänä Accounts API -kutsuissa.
TikTokin palauttama token_type: kuka tahansa tokenin haltija voi käyttää sen avulla tilin resursseja.
Tilitunnus, jonka /tt_user/token_info/get/ palauttaa scopen rinnalla; sitä voi käyttää business_id-kenttänä Accounts API -kutsuissa.
Miten valtuutuskoodi saapuu sovellukseesi?
TikTok-tilin haltijan valtuutusosoitteen kautta. TikTok luo sen kehittäjäsovellukselle kohdassa My Apps, App Detail, Basic Information, kun sovelluksella on TikTok Accounts -oikeus. Tilin omistaja avaa osoitteen, tarkistaa oikeudet ja hyväksyy ne. TikTok ohjaa sitten selaimen sovelluksen uudelleenohjaus-URL:iin, johon on liitetty auth_code, sekä mahdollinen valtuutusosoitteen mukana ollut state-arvo. Koodi on voimassa 10 minuuttia ja sen voi käyttää vain kerran.
- Uudelleenohjaus-URL: absoluuttinen, alkaa https:// ja päättyy /-merkkiin, ilman kyselyosaa, ankkuria tai porttia, ja pituus on 10–512 merkkiä.
- Enintään 10 uudelleenohjaus-URL:ia per sovellus, yksi aktiivinen kerrallaan; aktivoitu URL luo oman valtuutusosoitteensa.
- state: valinnainen arvo, jonka TikTok palauttaa uudelleenohjauksessa; TikTok suosittelee sitä CSRF-suojaksi.
disable_auto_auth=1: näyttää tarkistussivun omistajille, jotka ovat aiemmin hyväksyneet samat oikeudet ja joita TikTok muuten ohjaa heti eteenpäin.
Miten koodi vaihdetaan tokeneiksi?
POST-pyynnöllä osoitteeseen /tt_user/oauth2/token/ palvelimeltasi JSON-muodossa. client_id ja client_secret ovat App ID ja Secret, jotka näkyvät kohdassa My Apps, App Detail, Basic Information; grant_type on authorization_code; auth_code on uudelleenohjauksen koodi; ja redirect_uri on oltava sama kuin sovellukseen asetettu TikTok-tilin haltijan uudelleenohjaus-URL.
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/oauth2/token/' \
-H 'Content-Type: application/json' \
-d '{
"client_id": "<APP_ID>",
"client_secret": "<APP_SECRET>",
"grant_type": "authorization_code",
"auth_code": "<AUTH_CODE>",
"redirect_uri": "https://app.example.com/tiktok/callback/"
}'Mitä tokenvastaus sisältää?
JSON-olio, jossa ovat code, message, request_id ja data. Code 0 tarkoittaa, että vaihto onnistui, ja data sisältää molemmat tokenit sekä tilin tunnuksen:
access_token: lyhytaikainen token API-kutsuihin, voimassa yhden päivän.token_type: Bearer, jonka TikTok kuvaa sellaiseksi, että kuka tahansa tokenin haltija voi käyttää sitä.- scope: tokenille myönnetyt oikeudet yhtenä pilkuilla erotettuna merkkijonona.
expires_in: access tokenin jäljellä olevat sekunnit ennen vanhenemista, TikTokin esimerkissä 86400.refresh_token: token, jolla käyttöoikeus uusitaan, voimassa vuoden; TikTokin ohje on säilyttää se.refresh_token_expires_in: refresh tokenin jäljellä olevat sekunnit ennen vanhenemista.open_id: TikTok-tilin sovelluskohtainen tunniste.
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"access_token": "<ACCESS_TOKEN>",
"token_type": "Bearer",
"scope": "user.info.basic,user.info.stats,user.insights,video.list,video.insights,video.publish,comment.list,comment.list.manage",
"expires_in": 86400,
"refresh_token": "<REFRESH_TOKEN>",
"refresh_token_expires_in": 31536000,
"open_id": "<OPEN_ID>"
}
}Miten token lähetetään API-kutsuissa?
Access-Token-nimisessä pyyntöotsikossa Accounts API -päätepisteissä, alkaen osoitteesta /business/get/ ja päättyen osoitteeseen /business/video/publish/. Tili nimetään business_id-kentässä, jonka arvo on saman vastauksen open_id. OAuth-päätepisteet toimivat päinvastoin: /tt_user/oauth2/token/, /tt_user/oauth2/refresh_token/ ja /tt_user/oauth2/revoke/ ottavat sovelluksen client_id:n ja client_secret:n JSON-rungossa eivätkä Access-Token-otsikkoa.
Miten käyttöoikeus uusitaan?
POST-pyynnöllä osoitteeseen /tt_user/oauth2/refresh_token/, jossa ovat client_id, client_secret, grant_type-arvona refresh_token ja tallennettu refresh_token. Vastauksessa on samat kentät kuin ensimmäisessä vaihdossa: uusi access_token expires_in-arvoineen, refresh_token seuraavaa uusimista varten ja sen jäljellä olevat sekunnit. Ajasta uusiminen ennen 24 tunnin kulumista sen sijaan, että odottaisit virhettä 40102.
import os, time, requests
API = "https://business-api.tiktok.com/open_api/v1.3"
def renew(refresh_token: str) -> dict:
r = requests.post(f"{API}/tt_user/oauth2/refresh_token/", json={
"client_id": os.environ["TIKTOK_APP_ID"],
"client_secret": os.environ["TIKTOK_APP_SECRET"],
"grant_type": "refresh_token",
"refresh_token": refresh_token,
}, timeout=30).json()
if r["code"] != 0: # 40103: the refresh token expired, so the owner authorizes again
raise RuntimeError(f"{r['code']}: {r['message']}")
d, now = r["data"], time.time()
return {
"access_token": d["access_token"],
"access_expires_at": now + d["expires_in"],
"refresh_token": d["refresh_token"], # keep it for the next renewal
"refresh_expires_at": now + d["refresh_token_expires_in"],
}Miten käyttöoikeus peruutetaan?
Sovelluksesta POST-pyynnöllä osoitteeseen /tt_user/oauth2/revoke/, jossa ovat client_id, client_secret ja peruutettava access_token; onnistuminen palauttaa code 0 ja tyhjän data-olion. Tilin omistaja voi peruuttaa oikeudet TikTok-sovelluksessa: Settings and privacy, Security, Manage app permissions, valitse sovellus ja valitse Remove access. Kun valtuutus on peruutettu, TikTok lopettaa comment.update-tapahtumien lähettämisen sovellukselle kyseiseltä tililtä.
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/oauth2/revoke/' \
-H 'Content-Type: application/json' \
-d '{"client_id": "<APP_ID>", "client_secret": "<APP_SECRET>", "access_token": "<ACCESS_TOKEN>"}'
# {"code": 0, "message": "OK", "request_id": "<REQUEST_ID>", "data": {}}Miten tokenia tarkastetaan?
POST-pyynnöllä osoitteeseen /tt_user/token_info/get/, joka ei vaadi omaa oikeutta: lähetä app_id ja access_token, ja data palauttaa app_id:n, scope:n ja creator_id:n. scope kertoo, mitä omistaja on myöntänyt, ja creator_id on tilin sovelluskohtainen tunniste, jonka Accounts API -kutsut ottavat business_id-arvona. TikTokin ohjeet ohjaavat kehittäjät tänne aina, kun kenttä vaatii scopen, jota tokenilla ei ehkä ole.
Mitkä virheet tulevat tokeneista?
TikTok asettaa ne vastauksen code-kenttään, yleensä HTTP-tilalla 200, joten tarkista code ennen kuin luotat kutsuun. Tokeneihin ja niiden vaihtoon liittyvät paluukoodit:
- 40102: access token on vanhentunut; uusi se ja kutsu uudelleen.
- 40103: refresh token on vanhentunut; vain omistajan uusi valtuutus korvaa sen.
- 40104: pyynnössä ei ollut access tokenia.
- 40105: access token on virheellinen tai väärin muotoiltu.
- 40107: refresh token on virheellinen tai väärin muotoiltu, esimerkiksi Marketing API -tokenin uusimiseen lähetetty, joka ei koskaan vanhene.
- 40110: valtuutuskoodi on peruutettu, jo käytetty tai vanhentunut.
- 40131: todennusvirhe molemmissa token-päätepisteissä, jonka syynä on väärä App ID tai Secret, vanhentunut koodi tai virheellinen tai vanhentunut refresh token.
Mitä easyCoexistence uusii puolestasi?
Kaiken kirjautumisen jälkeen. easyCoexistence vaihtaa koodin heti, kun TikTok ohjaa takaisin, tallentaa molemmat tokenit salattuina ja uusii access tokenin itse: ennen kutsua, kun jäljellä on alle 15 minuuttia, ja tarkistuksessa, jonka se tekee jokaiselle tilille noin 6 tunnin välein, kun jäljellä on alle 8 tuntia. Jokainen uusiminen tallentaa uuden refresh tokenin ja sen vanhenemisajan, ja samaan aikaan saapuvat kutsut jakavat yhden uusimisen.
- Hylätty token: kun TikTok vastaa 40102, 40104 tai 40105, yhteys merkitään yhdistettäväksi uudelleen ja omistaja saa sähköpostin; Partner API -käyttäjät saavat myös channel.disconnected-tapahtuman.
- Oma koodi:
get_social_credentialstai Partner API:n GET /channels/{id}?credentials=1 palauttaa nykyisen tokenintoken_expires_at-arvoineen, joten hae se jokaiselle työlle erikseen. - Poistaminen: yhteyden poistaminen hallintapaneelista tai DELETE /channels/{id} peruuttaa tokenin TikTokissa päätepisteen /
tt_user/oauth2/revoke/ kautta.
Yleiset virheet
- Valtuutuskoodin vaihtaminen selaimessa. Vaihto lähettää sovelluksen client_secretin, joten tee se palvelimeltasi, 10 minuutin sisällä uudelleenohjauksesta.
- expires_in:n lukeminen päivämääränä. Se kertoo jäljellä olevat sekunnit, joten lisää se vastauksen aikaan, jotta tiedät, milloin token vanhenee.
- Peruuttaminen refresh tokenilla. /tt_user/oauth2/revoke/ ottaa access_tokenin sekä sovelluksen client_id:n ja client_secretin.
- Puuttuvan suostumusnäytön pitäminen virheenä. TikTok ohittaa tarkistussivun oikeuksille, jotka omistaja on aiemmin hyväksynyt; lisää disable_auto_auth=1, jotta sivu näkyy uudelleen.
Näin Claude, ChatGPT tai oma koodisi kutsuu TikTokia ajantasaisella tokenilla, jonka get_social_credentials antaa skripteillesi. US$ 9–US$ 0,75 per yhteys kuukaudessa, hinta laskee yhteyksien lisääntyessä, ja ensimmäiset 3 päivää ovat ilmaiset.
Usein kysytyt kysymykset
Kuinka kauan TikTok API for Business -access token on voimassa?
24 tuntia. Jokainen tokenvastaus kertoo jäljellä olevat sekunnit expires_in-kentässä, ja vuoden voimassa oleva refresh token uusii sen.
Vaatiiko TikTokin refresh-päätepiste redirect_uri:n?
Sen parametritaulukossa luetellaan client_id, client_secret, grant_type ja refresh_token, ilman redirect_uri:ta, vaikka TikTokin todennusopas sanoo, että sen token-päätepisteet vaativat redirect_uri:n.
Lopettaako TikTok-tokenin peruuttaminen sen webhookit?
Kyllä. TikTok ei lähetä sovellukselle enää comment.update-tapahtumia kyseiseltä tililtä, ennen kuin omistaja valtuuttaa sovelluksen uudelleen.
Mistä TikTokin business_id tulee?
Token-vastauksen open_id-kentästä, jonka Accounts API -kutsut ottavat business_id-arvona. /tt_user/token_info/get/ palauttaa saman tunnuksen creator_id-kenttänä.
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