Mag-log inMagsimula ng Libreng Trial
easyCoexistence Mga Official API

TikTok API for Business access tokens: 24 na oras, i-refresh at i-revoke

Ang access token ng TikTok API for Business ay tumatagal ng 24 oras at ipinapadala sa Access-Token header. Nakukuha ito ng app sa pamamagitan ng pagpapalit ng authorization code ng may-ari sa /tt_user/oauth2/token/, kasama ang refresh token na tumatagal ng isang taon at nagre-renew ng access sa /tt_user/oauth2/refresh_token/. I-revoke ito sa /tt_user/oauth2/revoke/, at ipakita ang mga scope na ibinigay sa /tt_user/token_info/get/.

Ipinapalit ng easyCoexistence ang code kapag nag-sign in ang isang TikTok account, nire-renew ang 24 oras na token bago ito maubos, at tinitingnan ang account humigit-kumulang bawat 6 na oras, para tumawag ang Claude, ChatGPT o sarili ninyong code sa TikTok gamit ang kasalukuyang token, na ibinibigay ng get_social_credentials sa inyong mga script.

24 hours

Haba ng buhay ng access token ng TikTok account; bawat sagot ng token ay nagsasaad ng natitirang segundo sa expires_in.

1 year

Bisa ng refresh token na inisyu kasama nito; ibinibigay ng refresh_token_expires_in ang natitirang segundo nito.

10 minutes

Gaano katagal ang authorization code sa redirect; isang beses lang itong maaaring palitan.

open_id

Application-specific ID ng account, ibinabalik kasama ng bawat token at ipinapadala bilang business_id sa mga tawag sa Accounts API.

Bearer

Ang token_type na ibinabalik ng TikTok: sinumang may hawak ng token ay magagamit ito para maabot ang resources ng account.

creator_id

Account ID na ibinabalik ng /tt_user/token_info/get/ kasama ng scope ng token, magagamit bilang business_id sa mga tawag sa Accounts API.

Paano nakakarating sa app ninyo ang authorization code?

Sa pamamagitan ng TikTok account holder authorization URL, na ginagawa ng TikTok para sa developer app sa My Apps, App Detail, Basic Information kapag hawak na ng app ang TikTok Accounts permission. Bubuksan ito ng may-ari ng account, susuriin ang mga permission at aaprubahan ang mga ito. Ipinapadala ng TikTok ang browser sa redirect URL ng app na may nakadugtong na auth_code, kasama ang anumang state value na dala ng authorization URL, at ang code na ito ay valid nang 10 minuto at isang beses lang magagamit sa exchange.

  • Redirect URL: absolute, nagsisimula sa https://, nagtatapos sa /, walang query string, anchor o port, at 10 hanggang 512 na karakter ang haba.
  • Hanggang 10 redirect URL bawat app, isa lang ang aktibo sa isang pagkakataon; ang pag-activate ng isa ay nagbubuo ng sarili nitong authorization URL.
  • state: opsyonal na value na ibinabalik ng TikTok sa redirect, na iminumungkahi nito bilang proteksyon laban sa CSRF.
  • disable_auto_auth=1: ipinapakita ang review page sa mga may-ari na nag-approve na ng parehong permission noon, na kung hindi ay agad nire-redirect ng TikTok.

Paano ipinapalit ang code sa mga token?

Sa pamamagitan ng POST sa /tt_user/oauth2/token/ mula sa server ninyo, bilang JSON. Ang client_id at client_secret ay ang App ID at Secret na makikita sa My Apps, App Detail, Basic Information; ang grant_type ay authorization_code; ang auth_code ay ang code mula sa redirect; at dapat tumugma ang redirect_uri sa TikTok account holder redirect URL na nakatakda sa app.

Exchange the authorization code
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/"
  }'

Ano ang nilalaman ng sagot ng token?

Isang JSON object na may code, message, request_id at data. Ang code na 0 ay nangangahulugang gumana ang exchange, at ang data ay naglalaman ng parehong token at ID ng account:

  • access_token: ang panandaliang token para sa API calls, valid nang isang araw.
  • token_type: Bearer, na inilalarawan ng TikTok bilang magagamit ng sinumang may hawak ng token.
  • scope: ang mga permission na ibinigay sa token, bilang iisang string na pinaghihiwalay ng kuwit.
  • expires_in: ang segundo na natitira bago mag-expire ang access token, 86400 sa halimbawa ng TikTok.
  • refresh_token: ang token na nagre-renew ng access, valid nang isang taon; ang paalala ng TikTok ay itago ito.
  • refresh_token_expires_in: ang segundo na natitira bago mag-expire ang refresh token.
  • open_id: ang application-specific ID ng TikTok account.
A token response (scope shortened)
{
  "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>"
  }
}

Paano ipinapadala ang token sa mga API call?

Sa header na pinangalanang Access-Token ng bawat tawag, sa mga Accounts API endpoint mula /business/get/ hanggang /business/video/publish/, habang ang account mismo ay tinutukoy sa business_id, na itinakda sa open_id mula sa parehong sagot. Baligtad ang gamit ng mga OAuth endpoint: ang /tt_user/oauth2/token/, /tt_user/oauth2/refresh_token/ at /tt_user/oauth2/revoke/ ay kumukuha ng client_id at client_secret ng app sa JSON body at walang Access-Token header.

Paano nire-renew ang access token?

Sa pamamagitan ng POST sa /tt_user/oauth2/refresh_token/ na may dalang client_id, client_secret, grant_type na nakatakda sa refresh_token, at ang naka-imbak na refresh_token. Ang sagot ay may parehong field ng unang exchange: bagong access_token kasama ang expires_in nito, isang refresh_token na itatago para sa susunod na renewal, at ang segundo na natitira rito. Iiskedyul ang renewal bago ang 24 oras sa halip na hintayin ang error 40102.

Renew a TikTok account access token in Python
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"],
    }

Paano binabawi ang access?

Mula sa app, sa pamamagitan ng POST sa /tt_user/oauth2/revoke/ na may client_id, client_secret at access_token na babawiin; kapag matagumpay, nagbabalik ito ng code 0 na may walang laman na data object. Mula sa account, bubuksan ng may-ari ang TikTok app, pupunta sa Settings and privacy, Security, Manage app permissions, pipiliin ang app at pipiliin ang Remove access. Kapag nabawi na ang authorization, hihinto ang TikTok sa pagpapadala ng comment.update event ng app para sa account na iyon.

Revoke a TikTok account access token
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": {}}

Paano sinusuri ang token?

Sa pamamagitan ng POST sa /tt_user/token_info/get/, na hindi nangangailangan ng sariling permission: ipadala ang app_id at access_token, at ibabalik ng data ang app_id, scope at creator_id. Nakalista sa scope ang ibinigay ng may-ari, at ang creator_id ay ang application-specific ID ng account, ang value na tinatanggap ng Accounts API calls bilang business_id. Dinidirekta ng mga reference ng TikTok ang developer dito tuwing kailangan ng field ng scope na maaaring wala sa token.

Anong mga error ang galing sa token?

Inilalagay ito ng TikTok sa code field ng sagot, karaniwan sa ilalim ng HTTP status 200, kaya tingnan ang code bago pagkatiwalaan ang isang call. Ang mga return code na kaugnay ng token at ng exchange nito:

  • 40102: nag-expire na ang access token; i-renew ito at tawagin ulit.
  • 40103: nag-expire na ang refresh token; tanging bagong authorization ng may-ari ang makapapalit dito.
  • 40104: walang access token ang tawag.
  • 40105: hindi valid o mali ang access token.
  • 40107: hindi valid o mali ang refresh token, halimbawa kung ipinadala ito para i-renew ang Marketing API token, na hindi nag-e-expire kailanman.
  • 40110: nakansela, nagamit na, o nag-expire na ang authorization code.
  • 40131: authentication error sa dalawang token endpoint, dahil sa maling app ID o secret, nag-expire na code, o hindi valid o nag-expire na refresh token.

Ano ang nire-renew ng easyCoexistence para sa inyo?

Lahat pagkatapos ng sign-in. Ipinapalit ng easyCoexistence ang code sa sandaling mag-redirect pabalik ang TikTok, iniimbak ang parehong token na naka-encrypt, at nire-renew mismo ang access token: bago ang isang call kapag mas mababa sa 15 minuto ang natitira, at sa check na tumatakbo sa bawat account humigit-kumulang bawat 6 na oras kapag mas mababa sa 8 oras ang natitira. Ang bawat renewal ay nag-iimbak ng bagong refresh token at expiry nito, at ang mga call na sabay-sabay dumating ay nagbabahagi ng iisang renewal.

  • Tinanggihang token: kapag sumagot ang TikTok ng 40102, 40104 o 40105, mamarkahan ang koneksyon para muling i-connect at makakatanggap ang may-ari ng email; ang mga user ng Partner API ay tatanggap din ng channel.disconnected.
  • Sariling code ninyo: ibinabalik ng get_social_credentials, o ng GET /channels/{id}?credentials=1 sa Partner API, ang kasalukuyang token kasama ang token_expires_at, kaya kunin ito kada job.
  • Pag-alis: ang pag-alis ng koneksyon sa dashboard, o gamit ang DELETE /channels/{id}, ay nagbabawi ng token sa TikTok sa pamamagitan ng /tt_user/oauth2/revoke/.

Mga karaniwang pagkakamali

  • Pagpapalit ng authorization code sa browser. Nagpapadala ang exchange ng client_secret ng app, kaya gawin ito sa server ninyo, sa loob ng 10 minuto mula sa redirect.
  • Pagbasa sa expires_in bilang petsa. Segundo ang natitira rito, kaya idagdag ito sa oras ng sagot para malaman kung kailan mag-e-expire ang token.
  • Pag-revoke gamit ang refresh token. Ang /tt_user/oauth2/revoke/ ay tumatanggap ng access_token, kasama ang client_id at client_secret ng app.
  • Pag-iisip na failure ang nawawalang consent screen. Nilalaktawan ng TikTok ang review page para sa mga permission na naaprubahan na ng may-ari; idagdag ang disable_auto_auth=1 para ipakita itong muli.
Ginagawa ito gamit ang EasyCoexistence

Mula US$ 9 hanggang US$ 0.75 kada koneksyon kada buwan, bumababa habang dumarami ang koneksyon ninyo, na may unang 3 araw na free trial.

Mga madalas itanong

Gaano katagal ang isang access token ng TikTok API for Business?

24 oras. Ibinibigay ng bawat sagot ng token ang segundong natitira sa expires_in, at ang refresh token, valid nang isang taon, ang nagre-renew nito.

Kailangan ba ng TikTok refresh endpoint ng redirect_uri?

Nakalista sa parameter table nito ang client_id, client_secret, grant_type at refresh_token, walang redirect_uri, bagama't sinasabi ng gabay sa authentication ng TikTok na kailangan ng mga token endpoint nito ang redirect_uri.

Pinipigilan ba ng pag-revoke ng TikTok token ang mga webhook nito?

Oo. Hindi na magpapadala ang TikTok ng comment.update event sa app para sa account na iyon hanggang muling i-authorize ng may-ari ang app.

Saan galing ang TikTok business_id?

Sa open_id sa sagot ng token, na tinatanggap ng Accounts API calls bilang business_id. Ibinabalik ng /tt_user/token_info/get/ ang parehong ID bilang creator_id.

Magpatuloy sa pagbabasa

I-connect ang inyong unang channel sa loob ng dalawang minuto.

Walang review ng platform na hihintayin. I-connect ang WhatsApp, Instagram, TikTok o iba pang channel, pagkatapos ay utusan ang inyong AI na mag-post, mag-reply o gumawa ng report, at panoorin itong gumana.

  • 3 araw na libre
  • Mag-cancel anumang oras
  • Official API lang
  • Minomonitor 24/7

Na-verify noong