Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Mengapa sambungan TikTok API berhenti berfungsi dan cara mengekalkannya

Sambungan TikTok API for Business berhenti berfungsi apabila token akses 24 jam tidak diperbaharui, token penyegaran setahun tamat tempoh, pemilik mengeluarkan akses aplikasi, atau token yang dihantar hilang atau salah. TikTok melaporkan kes token sebagai 40102, 40103, 40104 dan 40105. Memperbaharui token lebih awal, memeriksa setiap akaun mengikut jadual dan meminta pemilik memberi kebenaran semula sebelum tahun tamat memastikan sambungan kekal aktif.

easyCoexistence mengekalkan setiap sambungan TikTok secara sendiri: ia memperbaharui token 24 jam lebih awal, memeriksa akaun kira-kira setiap 6 jam, dan apabila TikTok menolak token, ia menandakan saluran sebagai Perlu sambung semula dan menghantar e-mel kepada anda, untuk Claude, ChatGPT atau platform anda sendiri.

24 hours

Tempoh hayat token akses akaun TikTok daripada API for Business; /tt_user/oauth2/refresh_token/ memperbaharuinya.

1 year

Tempoh hayat token penyegaran; selepas tamat tempoh, pemilik akaun perlu memberi kebenaran semula kepada aplikasi.

auth_removed

Sebab kegagalan apabila pemilik mengeluarkan akses aplikasi semasa TikTok memproses hantaran; TikTok menyatakan jangan cuba semula.

comment.update

Peristiwa yang TikTok berhenti hantar bagi sesuatu akaun selepas kebenaran pemilik tamat tempoh atau dibatalkan.

5 reasons

Sebab peristiwa authorization.removed daripada TikTok for Developers dicetuskan: pengguna memutuskan sambungan, akaun dipadam, perubahan umur, larangan, atau pembangun membatalkan akses.

6 hours

Kekerapan easyCoexistence memeriksa setiap akaun TikTok yang disambungkan; ia memperbaharui token 24 jam secara automatik dan menghantar e-mel kepada anda jika sambung semula diperlukan.

Mengapa sambungan TikTok API berhenti berfungsi?

Atas beberapa sebab, kebanyakannya berkait dengan token akaun atau kebenaran pemilik. Ada yang menamatkan sambungan sepenuhnya, manakala yang lain hanya berfungsi separa, dengan sesetengah panggilan ditolak dan selebihnya masih menjawab:

Access token expired24 hours passed without a renewal, and calls return 40102
Refresh token expiredIts year ended: renewal returns 40103 until the owner signs in again
Access removedThe owner chose Remove access in TikTok, or the app revoked the token
Wrong tokenMissing from the request (40104), or invalid or incorrect (40105)
Missing permissionA call outside the granted permissions returns 40001
Account level changedData tied to Advanced Access or verification is no longer available
App access revokedTikTok can revoke an app's Accounts API access for misuse, without notice

Apakah ralat yang dikembalikan oleh setiap punca, dan bagaimana ia diperbetulkan?

Medan code TikTok menamakan kebanyakannya, di dalam respons HTTP 200 dan bukannya status ralat, dan status penerbitan menambah sebab kegagalan tersendiri. 40100 dimasukkan ke dalam jadual kerana panggilan yang dihadkan boleh kelihatan seperti sambungan yang hilang. Maksud setiap satu, dan penyelesaiannya:

What it meansThe fix
40102The access token is past its 24 hoursRenew with the refresh token, store both new tokens, repeat the call
40103The refresh token has expiredA new authorization by the owner; nothing renews it
40104The request carried no access tokenA bug in the request: send the Access-Token header
40105The access token is invalid or incorrectCheck what was sent, renew, then ask the owner to authorize again
40107The refresh token is invalid or incorrectSend the refresh token from the latest response, or a new authorization
40131Authentication failed at a token endpointCheck the app ID and secret, then the code or the refresh token
40001A permission or scope is missingAdd it to the app, then have the owner authorize again
auth_removedAccess was removed while a post was processingNo retry; publish again after a new authorization
40100Throttled, not disconnectedPause the endpoint 5 minutes; the token still works

Berapa lama token bertahan, dan bilakah perlu diperbaharui?

Pada API for Business, token akses bertahan 24 jam, dan expires_in dalam setiap respons token memberi baki saat; token penyegaran bertahan setahun, dengan kiraan masa sendiri dalam refresh_token_expires_in. Perbaharui jauh sebelum hari tamat, mengikut jadual dan bukan selepas panggilan gagal, dan simpan token penyegaran yang dikembalikan setiap kali pembaharuan, kerana nota TikTok untuk medan itu ialah supaya ia dikekalkan. Anggap refresh_token_expires_in sebagai tarikh akhir: dalam contoh pembaharuan TikTok, ia mengira mundur dan bukannya memulakan tahun baharu.

Apa yang berlaku apabila pemilik mengeluarkan akses aplikasi?

Aplikasi kehilangan kebenaran Accounts API yang diberikan oleh pemilik, jadi panggilan dengan token itu berhenti berfungsi, dan TikTok tidak mendokumentasikan peristiwa API for Business yang mengumumkannya. Pemilik boleh berbuat demikian pada bila-bila masa dalam aplikasi TikTok, di bawah Tetapan dan privasi, Keselamatan, Urus kebenaran aplikasi, Buang akses. Tandanya muncul di tempat lain: siaran yang TikTok sedang proses gagal dengan auth_removed, yang TikTok nyatakan jangan cuba semula, dan peristiwa comment.update bagi akaun itu berhenti tiba.

Apakah kesan perubahan jenis akaun terhadap sambungan?

TikTok tidak mengaitkan sebarang ralat token dengannya dalam dokumennya; yang berubah ialah apa yang dikembalikan API. Data seperti unique_video_views, daily_new_followers dan audience_activity memerlukan Advanced Access atau Verified Business Account, begitu juga API Mentions dan API Business Messaging, dan privacy_level_options bagi akaun persendirian tidak menyertakan PUBLIC_TO_EVERYONE. Sejak 16 Oktober 2026, is_business_account hanya bernilai true bagi Verified Business Account dan has_advanced_access melaporkan Advanced Access, jadi membaca kedua-duanya di bawah user.account.type menunjukkan perubahan sebelum panggilan gagal.

Bagaimana anda mengesan sambungan yang mati sebelum pelanggan mengesannya?

Dengan semakan yang berjalan sama ada atau tidak sesiapa sedang menyiarkan:

  • Panggilan ringan bagi setiap akaun mengikut jadual, seperti /business/get/ dengan medan username, yang mengembalikan ralat token apabila token berhenti berfungsi.
  • /tt_user/token_info/get/, yang tidak memerlukan kebenaran dan mengembalikan skop token, untuk mengesahkan kebenaran masih meliputi apa yang dipanggil oleh ciri anda.
  • refresh_token_expires_in ditukar kepada tarikh apabila setiap respons tiba, dengan peringatan kepada pemilik beberapa minggu sebelumnya.
  • Senyap pada comment.update bagi akaun yang biasanya menerima komen, kerana TikTok berhenti menghantar peristiwa itu apabila kebenaran tamat tempoh atau dibatalkan.
  • 40102, 40103, 40104 dan 40105 dikira bagi setiap akaun, supaya satu akaun yang gagal menonjol di antara ramai.

Bagaimana anda menyambung semula akaun?

Dengan menjalankan kebenaran semula bagi akaun yang sama. Kongsi URL kebenaran pemegang akaun TikTok, dengan nilai state yang mengaitkan pulangan dengan akaun itu, dan disable_auto_auth=1 jika pemilik perlu melihat halaman kebenaran sekali lagi. Tukar auth_code baharu di /tt_user/oauth2/token/ dalam tempoh 10 minit, kemudian gantikan kedua-dua token yang disimpan. open_id ialah ID khusus aplikasi TikTok bagi akaun itu, jadi padankan token baharu dengan rekod yang disimpan melaluinya dan bukannya mencipta rekod kedua.

Adakah sambungan Content Posting API tamat tempoh dengan cara yang sama?

Tidak. TikTok for Developers, yang menyediakan Content Posting dan Display API, mengemas kini halaman tokennya pada 2 November 2026: token akses pengguna tamat dalam tempoh 2 jam dan token penyegaran bertahan 180 hari dari penerbitan pertama. Token penyegarannya dirotasi, jadi setiap penyegaran yang berjaya mengembalikan yang baharu dan serta-merta membatalkan yang dihantar, dan jika pelayan terus menggunakan token yang digantikan, penyegaran seterusnya gagal dan pengguna perlu memberi kebenaran semula. Token penyegaran yang buruk gagal dengan invalid_grant, token akses yang buruk dengan access_token_invalid dan HTTP 401, dan webhook authorization.removed memberitahu sebabnya apabila pengguna keluar.

Apakah yang dilakukan easyCoexistence untuk mengekalkan sambungan TikTok?

Ia memperbaharui dan memeriksa sendiri, dan memberitahu anda apabila hanya pemilik boleh membetulkannya:

  • Pembaharuan: sebelum panggilan apabila kurang daripada 15 minit tinggal, dan semasa semakan apabila kurang daripada 8 jam tinggal, sambil menyimpan token penyegaran baharu dan tarikh tamatnya setiap kali.
  • Satu pembaharuan pada satu masa bagi setiap akaun, jadi panggilan yang tiba serentak berkongsinya.
  • Semakan: panggilan /business/get/ untuk username akaun kira-kira setiap 6 jam.
  • Token yang ditolak, 40102, 40104 atau 40105: saluran membaca Perlu sambung semula, pemilik menerima satu e-mel, dan platform menerima channel.disconnected, dengan mesej TikTok sebagai disconnected_reason.
  • Sehingga itu, alat menjawab bahawa akaun perlu disambung semula, dan siaran berjadual gagal dengan status sambung semula dan bukannya sampai ke TikTok.
  • Menyambung semula: klik Sambung TikTok pada halaman saluran, atau sesi sambungan baharu, log masuk semula dan mengekalkan account_id dan destinasi peristiwa yang sama.

Cara menetapkannya

  1. 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.
  2. 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.
  3. Check each accountMake one light call per account on a schedule and record any 40102, 40103, 40104 or 40105 against that account.
  4. 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.
  5. Reconnect on a token errorWhen renewal fails or the token is refused, stop calling for that account and send its owner the authorization URL.

Kesilapan biasa

  • Menganggap webhook komen yang senyap sebagai akaun yang senyap. TikTok berhenti menghantar comment.update bagi sesuatu akaun apabila kebenarannya tamat, jadi semak akaun itu dan jangan tunggu peristiwa.
  • Menyambung semula ke dalam rekod baharu. Padankan token baharu melalui open_id, ID khusus aplikasi TikTok bagi akaun itu, dan kemas kini rekod yang disimpan di tempatnya, dengan mengekalkan sejarah dan tetapannya.
  • Mencuba semula 40103 atau 40107 dengan token penyegaran yang sama. Kedua-duanya tidak hilang apabila dicuba semula: yang pertama memerlukan kebenaran baharu, yang kedua memerlukan token penyegaran daripada respons terkini atau kebenaran baharu.
  • Membaca 40100 sebagai sambungan yang hilang. Ia ialah panggilan yang dihadkan; hentikan sementara endpoint selama 5 minit, atau sehingga 00:00 UTC selepas had harian, dan token yang sama terus berfungsi.
Menggunakan EasyCoexistence untuk ini

US$ 9 hingga US$ 0.75 bagi setiap sambungan sebulan, berkurang apabila anda menambah sambungan, dengan 3 hari percubaan percuma.

Soalan lazim

Bolehkah sambungan TikTok API kekal tanpa pemilik?

Tidak. Pembaharuan membawanya melalui tempoh token penyegaran setahun paling lama; selepas itu, laluan yang didokumentasikan TikTok ialah kebenaran baharu oleh pemilik akaun.

Mengapa sambungan TikTok gagal untuk beberapa akaun serentak?

Lihat aplikasi sebelum akaun: 40113 bermakna aplikasi disekat atau ID dan rahsianya tidak sepadan, dan TikTok boleh membatalkan akses Accounts API aplikasi kerana salah guna.

Adakah ciri baharu bermaksud menyambung semula akaun TikTok?

Apabila ciri itu memerlukan skop yang tidak pernah diberikan pemilik, ya. Token mengekalkan skop yang diluluskan semasa kebenaran, jadi pemilik perlu memberi kebenaran semula aplikasi untuk menambah satu.

Apa yang berlaku kepada siaran TikTok berjadual semasa akaun perlu disambung semula?

Di easyCoexistence, siaran itu gagal dengan status sambung semula pada masanya dan bukannya sampai ke TikTok, pemilik menerima e-mel, dan Cuba semula menghantarnya sebaik sahaja akaun disambungkan semula.

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