Token akses TikTok API for Business: 24 jam, segar semula dan batalkan
Token akses TikTok API for Business bertahan 24 jam dan dihantar dalam header Access-Token. Aplikasi memperolehnya dengan menukar kod kebenaran pemilik di /tt_user/oauth2/token/, bersama token segar semula yang bertahan setahun dan mengemas kini akses di /tt_user/oauth2/refresh_token/. Batalkannya di /tt_user/oauth2/revoke/, dan senaraikan skop yang diberikan di /tt_user/token_info/get/.
easyCoexistence menukar kod apabila akaun TikTok log masuk, menyegarkan token 24 jam sebelum ia tamat dan memeriksa akaun kira-kira setiap 6 jam, supaya Claude, ChatGPT atau kod anda sendiri memanggil TikTok dengan token semasa, yang get_social_credentials serahkan kepada skrip anda.
Tempoh sah token akses akaun TikTok; setiap respons token menyatakan baki saat dalam expires_in.
Tempoh sah token segar semula yang dikeluarkan bersamanya; refresh_token_expires_in memberi baki saatnya.
Tempoh kod kebenaran dalam URL pengalihan kekal sah; ia hanya boleh ditukar sekali.
ID khusus aplikasi bagi akaun, dikembalikan bersama setiap token dan dihantar sebagai business_id dalam panggilan Accounts API.
token_type yang dikembalikan TikTok: sesiapa yang memegang token boleh menggunakannya untuk mencapai sumber akaun.
ID akaun yang dikembalikan oleh /tt_user/token_info/get/ bersama skop token, boleh digunakan sebagai business_id dalam panggilan Accounts API.
Bagaimana kod kebenaran sampai ke aplikasi anda?
Melalui URL kebenaran pemegang akaun TikTok, yang dijana TikTok untuk aplikasi pembangun di bawah My Apps, App Detail, Basic Information apabila aplikasi memiliki kebenaran TikTok Accounts. Pemilik akaun membukanya, menyemak kebenaran dan meluluskannya. Kemudian TikTok menghantar pelayar ke URL pengalihan aplikasi dengan auth_code dilampirkan, serta sebarang nilai state yang dibawa oleh URL kebenaran, dan kod itu sah selama 10 minit untuk satu pertukaran sahaja.
- URL pengalihan: mutlak, bermula dengan https://, berakhir dengan /, tanpa query string, anchor atau port, dan panjangnya 10 hingga 512 aksara.
- Sehingga 10 URL pengalihan bagi setiap aplikasi, satu aktif pada satu-satu masa; mengaktifkan satu URL menjana URL kebenarannya sendiri.
- state: nilai pilihan yang TikTok ulang semula pada pengalihan, dicadangkan sebagai pengawal terhadap CSRF.
disable_auto_auth=1: memaparkan halaman semakan kepada pemilik yang sudah meluluskan kebenaran yang sama sebelum ini, yang jika tidak akan dialihkan terus oleh TikTok.
Bagaimana anda menukar kod kepada token?
Dengan POST ke /tt_user/oauth2/token/ dari pelayan anda, dalam format JSON. client_id dan client_secret ialah App ID dan Secret yang dipaparkan di bawah My Apps, App Detail, Basic Information; grant_type ialah authorization_code; auth_code ialah kod daripada pengalihan; dan redirect_uri mesti sama dengan URL pengalihan akaun TikTok yang ditetapkan dalam aplikasi.
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/"
}'Apa yang terkandung dalam respons token?
Objek JSON dengan code, message, request_id dan data. Kod 0 bermakna pertukaran berjaya, dan data membawa kedua-dua token serta ID akaun:
access_token: token jangka pendek untuk panggilan API, sah selama satu hari.token_type: Bearer, yang TikTok terangkan sebagai boleh digunakan oleh sesiapa yang memegang token.- scope: kebenaran yang diberikan kepada token, dalam satu rentetan dipisahkan koma.
expires_in: baki saat sebelum token akses tamat, 86400 dalam contoh TikTok.refresh_token: token yang menyegarkan akses, sah selama setahun; nota TikTok ialah supaya ia disimpan.refresh_token_expires_in: baki saat sebelum token segar semula tamat.open_id: ID khusus aplikasi bagi akaun TikTok.
{
"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>"
}
}Bagaimana token dihantar dalam panggilan API?
Dalam header permintaan bernama Access-Token, pada endpoint Accounts API dari /business/get/ hingga /business/video/publish/, manakala akaun itu sendiri dinamakan dalam business_id, ditetapkan kepada open_id daripada respons yang sama. Endpoint OAuth berfungsi sebaliknya: /tt_user/oauth2/token/, /tt_user/oauth2/refresh_token/ dan /tt_user/oauth2/revoke/ mengambil client_id dan client_secret aplikasi dalam badan JSON dan tidak menggunakan header Access-Token.
Bagaimana anda menyegarkan semula token akses?
Dengan POST ke /tt_user/oauth2/refresh_token/ yang membawa client_id, client_secret, grant_type ditetapkan kepada refresh_token, dan refresh_token yang disimpan. Jawapannya mempunyai medan yang sama seperti pertukaran pertama: access_token baharu dengan expires_in, refresh_token untuk disimpan bagi penyegaran seterusnya, dan saat yang masih ada padanya. Jadualkan penyegaran sebelum 24 jam, bukannya menunggu ralat 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"],
}Bagaimana anda membatalkan akses?
Daripada aplikasi, dengan POST ke /tt_user/oauth2/revoke/ yang membawa client_id, client_secret dan access_token yang hendak dibatalkan; kejayaan memulangkan code 0 dengan objek data kosong. Daripada akaun, pemilik membuka aplikasi TikTok, pergi ke Tetapan dan privasi, Keselamatan, Urus kebenaran aplikasi, pilih aplikasi dan pilih Alih keluar akses. Selepas kebenaran dibatalkan, TikTok berhenti menghantar acara comment.update bagi akaun itu kepada aplikasi.
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": {}}Bagaimana anda memeriksa token?
Dengan POST ke /tt_user/token_info/get/, yang tidak memerlukan kebenaran tersendiri: hantar app_id dan access_token, dan data memulangkan app_id, scope dan creator_id. scope menyenaraikan apa yang diberikan pemilik, dan creator_id ialah ID khusus aplikasi bagi akaun, nilai yang diambil oleh panggilan Accounts API sebagai business_id. Rujukan TikTok menghantar pembangun ke sini setiap kali medan memerlukan skop yang mungkin tiada pada token.
Ralat apa yang datang daripada token?
TikTok meletakkannya dalam medan code respons, biasanya di bawah status HTTP 200, jadi semak code sebelum mempercayai panggilan. Kod pulangan yang berkaitan dengan token dan pertukarannya:
- 40102: token akses telah tamat tempoh; segar semula dan panggil semula.
- 40103: token segar semula telah tamat tempoh; hanya kebenaran baharu oleh pemilik yang menggantikannya.
- 40104: permintaan tidak membawa token akses.
- 40105: token akses tidak sah atau tidak betul.
- 40107: token segar semula tidak sah atau tidak betul, contohnya yang dihantar untuk menyegarkan token Marketing API, yang tidak pernah tamat tempoh.
- 40110: kod kebenaran telah dibatalkan, sudah digunakan atau sudah tamat tempoh.
- 40131: ralat pengesahan pada dua endpoint token, akibat ID atau secret aplikasi yang salah, kod yang tamat tempoh, atau token segar semula yang tidak sah atau tamat tempoh.
Apa yang easyCoexistence segarkan untuk anda?
Segala-galanya selepas log masuk. easyCoexistence menukar kod sebaik sahaja TikTok dialihkan semula, menyimpan kedua-dua token yang disulitkan, dan menyegarkan token akses sendiri: sebelum panggilan apabila tinggal kurang 15 minit, dan semasa semakan yang dijalankan ke atas setiap akaun kira-kira setiap 6 jam apabila tinggal kurang 8 jam. Setiap penyegaran menyimpan refresh_token baharu dan tarikh luputnya, dan panggilan yang tiba serentak berkongsi satu penyegaran.
- Token ditolak: apabila TikTok menjawab 40102, 40104 atau 40105, sambungan ditandakan untuk disambung semula dan pemilik menerima e-mel; pengguna Partner API turut menerima channel.disconnected.
- Kod anda sendiri:
get_social_credentials, atau GET /channels/{id}?credentials=1 pada Partner API, memulangkan token semasa dengantoken_expires_at, jadi ambil setiap kerja. - Pemadaman: membuang sambungan dalam dashboard, atau dengan DELETE /channels/{id}, membatalkan token di TikTok melalui /
tt_user/oauth2/revoke/.
Kesilapan biasa
- Menukar kod kebenaran dalam pelayar. Pertukaran menghantar client_secret aplikasi, jadi lakukannya dari pelayan anda, dalam masa 10 minit selepas pengalihan.
- Membaca expires_in sebagai tarikh. Ia memegang baki saat, jadi tambahkannya pada masa respons untuk tahu bila token tamat.
- Membatalkan dengan token segar semula. /tt_user/oauth2/revoke/ mengambil access_token, bersama client_id dan client_secret aplikasi.
- Menganggap skrin persetujuan yang hilang sebagai kegagalan. TikTok melangkau halaman semakan bagi kebenaran yang diluluskan pemilik sebelum ini; tambahkan disable_auto_auth=1 untuk memaparkannya semula.
Daripada US$ 9 hingga US$ 0.75 setiap sambungan sebulan, berkurang apabila anda menambah sambungan, dengan percubaan percuma 3 hari pertama.
Soalan lazim
Berapa lama token akses TikTok API for Business bertahan?
24 jam. Setiap respons token memberi saat yang tinggal dalam expires_in, dan token segar semula, yang sah selama setahun, menyegarkannya.
Adakah endpoint penyegaran TikTok memerlukan redirect_uri?
Jadual parameternya menyenaraikan client_id, client_secret, grant_type dan refresh_token, tanpa redirect_uri, walaupun panduan pengesahan TikTok menyatakan endpoint token memerlukan redirect_uri.
Adakah membatalkan token TikTok menghentikan webhook-nya?
Ya. TikTok tidak lagi menghantar acara comment.update kepada aplikasi bagi akaun itu sehingga pemilik membenarkan aplikasi sekali lagi.
Dari mana business_id TikTok datang?
Daripada open_id dalam respons token, yang panggilan Accounts API ambil sebagai business_id. /tt_user/token_info/get/ memulangkan ID yang sama sebagai creator_id.
Teruskan membaca
Sambungkan saluran pertama anda dalam masa dua minit.
Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.
- 3 hari percuma
- Batal bila-bila masa
- API rasmi sahaja
- Dipantau 24/7
Disahkan pada