MasukMulai uji coba gratis
easyCoexistence API resmi

Mengapa koneksi TikTok API berhenti bekerja, dan cara menjaganya tetap aktif

Koneksi TikTok API for Business berhenti bekerja saat access token 24 jam tidak diperbarui, refresh token satu tahun habis, pemilik mencabut akses aplikasi, atau token yang dikirim hilang atau salah. TikTok mencatat kasus token sebagai 40102, 40103, 40104 dan 40105. Memperbarui token lebih awal, memeriksa tiap akun sesuai jadwal, dan meminta pemilik memberi otorisasi ulang sebelum tahun berakhir menjaga koneksi tetap aktif.

easyCoexistence menjaga setiap koneksi TikTok tetap aktif dengan sendirinya: memperbarui token 24 jam lebih awal, memeriksa akun sekitar setiap 6 jam, dan ketika TikTok menolak token, ia menandai saluran sebagai Perlu dihubungkan ulang dan mengirim email kepada Anda, untuk Claude, ChatGPT atau platform Anda sendiri.

24 hours

Masa berlaku access token akun TikTok dari API for Business; /tt_user/oauth2/refresh_token/ memperbaruinya.

1 year

Masa berlaku refresh token; setelah habis, pemilik akun harus memberi otorisasi aplikasi lagi.

auth_removed

Alasan gagal saat pemilik mencabut akses aplikasi ketika TikTok sedang memproses unggahan; TikTok menyatakan jangan mencoba ulang.

comment.update

Event yang berhenti dikirim TikTok untuk akun setelah otorisasi pemilik kedaluwarsa atau dicabut.

5 reasons

Alasan authorization.removed dari TikTok for Developers terpicu: pengguna memutus koneksi, akun dihapus, usia berubah, akun diblokir, atau developer mencabut.

6 hours

Seberapa sering easyCoexistence memeriksa setiap akun TikTok yang terhubung; ia memperbarui token 24 jam secara otomatis dan mengirim email kepada Anda jika perlu menghubungkan ulang.

Mengapa koneksi TikTok API berhenti bekerja?

Ada beberapa alasan, sebagian besar terkait token akun atau persetujuan pemilik. Sebagian langsung memutus koneksi, sementara lainnya membuatnya setengah berfungsi, dengan sebagian panggilan ditolak dan sisanya tetap merespons:

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

Kesalahan apa yang dikembalikan tiap penyebab, dan apa perbaikannya?

Kolom code TikTok menyebutkan sebagian besar, di dalam respons HTTP 200 dan bukan status kesalahan, dan status publikasi menambahkan alasan gagal tersendiri. 40100 masuk tabel karena panggilan yang kena pembatasan laju bisa tampak seperti koneksi yang hilang. Arti tiap kode dan perbaikannya:

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 kapan sebaiknya memperbarui?

Pada API for Business, access token berlaku 24 jam, dan expires_in di setiap respons token memberi jumlah detik yang tersisa; refresh token berlaku setahun, dengan hitung mundurnya sendiri di refresh_token_expires_in. Perbarui jauh sebelum hari berakhir, sesuai jadwal dan bukan setelah panggilan gagal, dan simpan refresh token yang dikembalikan setiap pembaruan, karena catatan TikTok untuk kolom itu menyatakan agar dipertahankan. Perlakukan refresh_token_expires_in sebagai tenggat: dalam contoh pembaruan TikTok, nilainya terus berkurang alih-alih mulai tahun baru.

Apa yang terjadi saat pemilik mencabut akses aplikasi?

Aplikasi kehilangan izin Accounts API yang diberikan pemilik, sehingga panggilan dengan token itu berhenti bekerja, dan TikTok tidak mendokumentasikan event API for Business yang mengumumkannya. Pemilik dapat melakukannya kapan saja di aplikasi TikTok, di bawah Pengaturan dan privasi, Keamanan, Kelola izin aplikasi, Cabut akses. Tanda-tandanya muncul di tempat lain: unggahan yang sedang diproses TikTok gagal dengan auth_removed, yang menurut TikTok jangan dicoba ulang, dan event comment.update untuk akun berhenti masuk.

Apa dampak perubahan jenis akun terhadap koneksi?

TikTok tidak mengaitkan kesalahan token dengan hal ini dalam dokumennya; yang berubah adalah apa yang dikembalikan API. Data seperti unique_video_views, daily_new_followers, dan audience_activity memerlukan Advanced Access atau Akun Bisnis Terverifikasi, begitu pula Mentions API dan Business Messaging API, dan privacy_level_options akun privat tidak mencantumkan PUBLIC_TO_EVERYONE. Sejak 16 Oktober 2026, is_business_account bernilai true hanya untuk Akun Bisnis Terverifikasi dan has_advanced_access menunjukkan Advanced Access, sehingga membaca keduanya, di bawah user.account.type, menunjukkan perubahan sebelum panggilan gagal.

Bagaimana mendeteksi koneksi mati sebelum pelanggan mengetahuinya?

Dengan pemeriksaan yang berjalan apakah ada yang memposting atau tidak:

  • Panggilan ringan per akun sesuai jadwal, misalnya /business/get/ dengan field username, yang mengembalikan kesalahan token begitu token berhenti bekerja.
  • /tt_user/token_info/get/, yang tidak memerlukan izin dan mengembalikan scope token, untuk memastikan izin masih mencakup apa yang dipanggil fitur Anda.
  • refresh_token_expires_in diubah menjadi tanggal saat setiap respons datang, dengan pengingat kepada pemilik beberapa minggu sebelumnya.
  • Tidak adanya comment.update pada akun yang biasanya menerima komentar, karena TikTok menghentikan event itu setelah otorisasi kedaluwarsa atau dicabut.
  • Kesalahan 40102, 40103, 40104 dan 40105 dihitung per akun, sehingga satu akun yang gagal menonjol di antara banyak akun.

Bagaimana menghubungkan ulang sebuah akun?

Dengan menjalankan otorisasi lagi untuk akun yang sama. Bagikan URL otorisasi pemegang akun TikTok, dengan nilai state yang mengaitkan kembalinya ke akun, dan disable_auto_auth=1 jika pemilik harus melihat halaman izin lagi. Tukarkan auth_code baru di /tt_user/oauth2/token/ dalam 10 menit, lalu ganti kedua token yang tersimpan. open_id adalah ID khusus aplikasi TikTok untuk akun, jadi cocokkan token baru dengan catatan tersimpan melalui ID itu, alih-alih membuat catatan kedua.

Apakah koneksi Content Posting API kedaluwarsa dengan cara yang sama?

Tidak. TikTok for Developers, yang menyediakan Content Posting dan Display API, memperbarui halaman tokennya pada 2 November 2026: access token pengguna kedaluwarsa dalam 2 jam dan refresh token berlaku 180 hari sejak pertama kali diterbitkan. Refresh token-nya berputar, sehingga setiap pembaruan yang berhasil mengembalikan yang baru dan langsung membatalkan yang dikirim. Jika server terus memakai token yang sudah diganti, pembaruan berikutnya gagal dan pengguna harus memberi otorisasi lagi. Refresh token yang buruk gagal dengan invalid_grant, access token yang buruk dengan access_token_invalid dan HTTP 401, dan webhook authorization.removed-nya menjelaskan alasan pengguna keluar.

Apa yang dilakukan easyCoexistence untuk menjaga koneksi TikTok tetap aktif?

Aplikasi memperbarui dan memeriksa sendiri, dan memberi tahu Anda ketika hanya pemilik yang dapat memperbaikinya:

  • Pembaruan: sebelum panggilan saat sisa waktu kurang dari 15 menit, dan saat pemeriksaan ketika sisa waktu kurang dari 8 jam, dengan menyimpan refresh token baru beserta masa berlakunya setiap kali.
  • Satu pembaruan per akun dalam satu waktu, sehingga panggilan yang datang bersamaan berbagi pembaruan yang sama.
  • Pemeriksaan: panggilan /business/get/ untuk username akun sekitar setiap 6 jam.
  • Token ditolak, yaitu 40102, 40104 atau 40105: saluran menampilkan Perlu dihubungkan ulang, pemilik menerima satu email, dan platform menerima channel.disconnected, dengan pesan TikTok sebagai disconnected_reason.
  • Sampai saat itu, alat menjawab bahwa akun perlu dihubungkan ulang, dan postingan terjadwal gagal dengan status reconnect alih-alih sampai ke TikTok.
  • Menghubungkan ulang: Hubungkan TikTok di halaman saluran, atau sesi koneksi baru, masuk lagi dan mempertahankan account_id serta tujuan event yang sama.

Cara mengonfigurasi

  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.

Kesalahan umum

  • Menganggap webhook komentar yang sepi sebagai akun yang sepi. TikTok menghentikan comment.update untuk akun begitu otorisasinya berakhir, jadi periksa akunnya alih-alih menunggu event.
  • Menghubungkan ulang menjadi catatan baru. Cocokkan token baru melalui open_id, ID khusus aplikasi TikTok untuk akun, dan perbarui catatan tersimpan di tempatnya, dengan mempertahankan riwayat dan pengaturannya.
  • Mencoba ulang 40103 atau 40107 dengan refresh token yang sama. Keduanya tidak hilang saat dicoba ulang: yang pertama memerlukan otorisasi baru, yang kedua memerlukan refresh token dari respons terbaru atau otorisasi baru.
  • Membaca 40100 sebagai koneksi yang hilang. Itu panggilan yang kena pembatasan laju; jeda endpoint 5 menit, atau sampai 00:00 UTC setelah batas harian, dan token yang sama tetap berfungsi.
Melakukan ini dengan EasyCoexistence

US$ 9 sampai US$ 0.75 per koneksi per bulan, turun seiring Anda menambah koneksi, dengan 3 hari pertama gratis.

Pertanyaan yang sering diajukan

Bisakah koneksi TikTok API bertahan tanpa pemilik?

Tidak. Pembaruan membawanya melewati tahun refresh token paling lama; setelah itu, jalur yang didokumentasikan TikTok adalah otorisasi baru oleh pemilik akun.

Mengapa koneksi TikTok gagal untuk beberapa akun sekaligus?

Periksa aplikasinya sebelum akunnya: 40113 berarti aplikasi diblokir atau ID dan kunci rahasianya tidak cocok, dan TikTok dapat mencabut akses Accounts API aplikasi karena penyalahgunaan.

Apakah fitur baru berarti menghubungkan ulang akun TikTok?

Jika fitur itu memerlukan scope yang tidak pernah diberikan pemilik, ya. Token mempertahankan scope yang disetujui saat otorisasi, sehingga pemilik perlu memberi otorisasi aplikasi lagi untuk menambahkannya.

Apa yang terjadi pada postingan TikTok terjadwal saat akun perlu dihubungkan ulang?

Di easyCoexistence, postingan itu gagal dengan status reconnect pada waktunya alih-alih sampai ke TikTok, pemilik menerima email, dan Coba lagi mengirimkannya setelah akun terhubung kembali.

Lanjut membaca

Hubungkan saluran pertama Anda dalam dua menit.

Tanpa menunggu peninjauan platform. Hubungkan WhatsApp, Instagram, TikTok, atau saluran lainnya, lalu minta AI Anda untuk memposting, membalas, atau membuat laporan, dan lihat hasilnya langsung.

  • Gratis 3 hari
  • Batalkan kapan saja
  • Hanya API resmi
  • Dipantau 24/7

Diverifikasi pada