Giriş yapınÜcretsiz denemeyi başlatın
easyCoexistence Resmi API'ler

TikTok API bağlantısı neden durur ve nasıl canlı tutulur

Bir TikTok API for Business bağlantısı; 24 saatlik erişim token'ı yenilenmediğinde, bir yıllık yenileme token'ı sona erdiğinde, hesap sahibi uygulamanın erişimini kaldırdığında veya gönderilen token eksik ya da hatalı olduğunda çalışmayı durdurur. TikTok token kaynaklı durumları 40102, 40103, 40104 ve 40105 olarak bildirir. Erkenden yenilemek, her hesabı bir takvime göre kontrol etmek ve yıl dolmadan hesap sahibinden yeniden yetkilendirme istemek bağlantıyı canlı tutar.

easyCoexistence her TikTok bağlantısını kendi başına canlı tutar: 24 saatlik token'ı önceden yeniler, hesabı yaklaşık her 6 saatte bir kontrol eder ve TikTok token'ı reddettiğinde kanalı Reconnect needed olarak işaretler ve size e-posta gönderir; Claude, ChatGPT veya kendi platformunuz için.

24 hours

API for Business üzerinden bir TikTok hesabı erişim token'ının ömrü; /tt_user/oauth2/refresh_token/ bunu yeniler.

1 year

Yenileme token'ının ömrü; süresi dolduğunda hesap sahibinin uygulamayı yeniden yetkilendirmesi gerekir.

auth_removed

TikTok bir gönderiyi işlerken hesap sahibi uygulamanın erişimini kaldırdığında oluşan hata nedeni; TikTok yeniden denenmemesini söyler.

comment.update

Hesap sahibinin yetkilendirmesi sona erdiğinde ya da iptal edildiğinde TikTok'in o hesap için göndermeyi durdurduğu olaylar.

5 reasons

TikTok for Developers'ın authorization.removed olayını tetikleyen nedenler: kullanıcı bağlantıyı koparır, hesap silinir, yaş değişir, hesap yasaklanır ya da geliştirici iptal eder.

6 hours

easyCoexistence'ın bağlı her TikTok hesabını ne sıklıkla kontrol ettiği; 24 saatlik token'ı kendiliğinden yeniler ve yeniden bağlanma gerektiğinde size e-posta gönderir.

TikTok API bağlantısı neden çalışmayı durdurur?

Bunun birkaç nedeni vardır; çoğu hesabın token'ları ya da hesap sahibinin onayıyla ilgilidir. Bazıları bağlantıyı tamamen keser, bazıları ise yarım çalışır bırakır: bazı çağrılar reddedilir, diğerleri yanıt vermeye devam eder:

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

Her neden hangi hatayı döndürür ve nasıl düzeltilir?

TikTok'in code alanı bunların çoğunu adlandırır; bu, bir hata durumu yerine HTTP 200 yanıtı içinde gelir. Yayınlama durumu ise kendi başarısızlık nedenini ekler. 40100, sınırlandırılmış bir çağrının kopmuş bağlantı gibi görünebilmesi nedeniyle tabloda yer alır. Her birinin anlamı ve çözümü:

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

Token'lar ne kadar yaşar ve ne zaman yenilenmelidir?

API for Business'ta erişim token'ı 24 saat geçerlidir; her token yanıtındaki expires_in, kalan saniyeleri verir. Yenileme token'ı bir yıl geçerlidir ve kalan süresi refresh_token_expires_in alanında ayrı bir geri sayımla gösterilir. Süre dolmadan çok önce, bir çağrı başarısız olduktan sonra değil, bir takvime göre yenileyin. Her yenilemede dönen yenileme token'ını saklayın; TikTok'in bu alandaki notu onu saklamaktır. refresh_token_expires_in değerini bir son tarih olarak ele alın: TikTok'in yenileme örneğinde yeni bir yıl başlatmak yerine geri sayar.

Hesap sahibi uygulamanın erişimini kaldırırsa ne olur?

Uygulama, hesap sahibinin verdiği Accounts API izinlerini kaybeder; bu token ile yapılan çağrılar çalışmayı durdurur. TikTok bunu duyuran bir API for Business olayı belgelemez. Hesap sahibi bunu her zaman TikTok uygulamasında, Settings and privacy, Security, Manage app permissions altında, Remove access seçeneğiyle yapabilir. Belirtiler başka yerlerde görünür: TikTok'in işlediği bir gönderi auth_removed ile başarısız olur; TikTok bunun yeniden denenmemesini söyler ve hesap için comment.update olayları gelmeyi durdurur.

Hesap türünün değişmesi bağlantıyı nasıl etkiler?

TikTok dokümanlarında buna bağlı bir token hatası yoktur; değişen, API'nin döndürdüğü veridir. unique_video_views, daily_new_followers ve audience_activity gibi veriler Advanced Access veya Doğrulanmış İşletme Hesabı gerektirir; Mentions ve Business Messaging API'leri de öyledir. Özel bir hesabın privacy_level_options alanı ise PUBLIC_TO_EVERYONE seçeneğini içermez. 16 Ekim 2026'dan itibaren is_business_account yalnızca Doğrulanmış İşletme Hesaplarında true değerini verir ve has_advanced_access Advanced Access durumunu bildirir. Bu nedenle user.account.type altında ikisini birlikte okumak, bir çağrı takılmadan önce değişikliği gösterir.

Müşteriniz fark etmeden ölü bir bağlantıyı nasıl yakalarsınız?

Birinin paylaşım yapıp yapmadığına bakılmaksızın çalışan kontrollerle:

  • Hesap başına, bir takvime göre hafif bir çağrı; örneğin fields alanında username ile /business/get/. Token çalışmayı durdurduğunda bu çağrı bir token hatası döndürür.
  • /tt_user/token_info/get/, izin gerektirmez ve token'ın kapsamını döndürür; özelliklerinizin çağırdığı işlemleri hâlâ kapsadığını doğrulamak için kullanın.
  • Her yanıt geldiğinde refresh_token_expires_in değerini bir tarihe çevirip, hesap sahibine haftalar önce hatırlatma göndermek.
  • Genellikle yorum alan bir hesapta comment.update olaylarının sessizliği; TikTok bu olayları yetkilendirme sona erdiğinde ya da iptal edildiğinde durdurur.
  • 40102, 40103, 40104 ve 40105 hatalarının hesap başına sayılması; böylece çok sayıda hesap arasında bir tanesi öne çıkar.

Bir hesabı nasıl yeniden bağlarsınız?

Aynı hesap için yetkilendirmeyi yeniden çalıştırarak. Dönüşü hesapla ilişkilendiren bir state değeri ile TikTok account holder authorization URL'sini paylaşın; hesap sahibinin izin sayfasını yeniden görmesi gerekiyorsa disable_auto_auth=1 ekleyin. Yeni auth_code değerini 10 dakika içinde /tt_user/oauth2/token/ üzerinden değiştirin, ardından saklanan her iki token'ı da değiştirin. open_id, TikTok'in hesap için uygulamaya özgü kimliğidir; bu yüzden yeni token'ları ikinci bir kayıt açmak yerine open_id ile saklanan kayda eşleştirin.

Content Posting API bağlantıları da aynı şekilde mi sona erer?

Hayır. Content Posting ve Display API'lerini sunan TikTok for Developers, 2 Kasım 2026'da token sayfalarını güncelledi: kullanıcı erişim token'ları 2 saat içinde sona erer, yenileme token'ları ise ilk verildikleri tarihten itibaren 180 gün geçerlidir. Yenileme token'ları döner; her başarılı yenileme yeni bir token verir ve gönderilen token'ı hemen geçersiz kılar. Sunucu değiştirilmiş bir token kullanmaya devam ederse sonraki yenilemeler başarısız olur ve kullanıcının yeniden yetkilendirmesi gerekir. Hatalı bir yenileme token'ı invalid_grant ile, hatalı bir erişim token'ı ise access_token_invalid ve HTTP 401 ile başarısız olur. authorization.removed webhook'u ise bir kullanıcının neden ayrıldığını açıklar.

easyCoexistence bir TikTok bağlantısını canlı tutmak için ne yapar?

Kendiliğinden yeniler ve kontrol eder; yalnızca hesap sahibinin çözebileceği durumlarda size haber verir:

  • Yenileme: 15 dakikadan az kaldığında bir çağrıdan önce; 8 saatten az kaldığında bir kontrol sırasında. Her seferinde yeni yenileme token'ını ve sona erme tarihini saklar.
  • Hesap başına aynı anda yalnızca bir yenileme yapılır; aynı anda gelen çağrılar bunu paylaşır.
  • Kontrol: hesabın username değeri için yaklaşık her 6 saatte bir /business/get/ çağrısı.
  • Reddedilen bir token (40102, 40104 veya 40105): kanal Reconnect needed durumunu gösterir, hesap sahibi tek bir e-posta alır ve bir platform channel.disconnected olayını alır; TikTok'in mesajı disconnected_reason olarak iletilir.
  • Bu duruma kadar araçlar hesabın yeniden bağlanması gerektiğini yanıtlar; zamanlanmış bir gönderi, TikTok'e ulaşmak yerine reconnect olarak başarısız olur.
  • Yeniden bağlanma: kanalın sayfasında Connect TikTok düğmesine tıklayın ya da yeni bir connect oturumu açın; hesap yeniden giriş yapar ve aynı account_id ile olay hedefini korur.

Nasıl kurulur

  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.

Yaygın hatalar

  • Sessiz bir yorum webhook'unu sessiz bir hesap sanmak. TikTok, yetkilendirme sona erdiğinde bir hesap için comment.update olaylarını durdurur; bu yüzden olayları beklemek yerine hesabı kontrol edin.
  • Yeni bir kayda yeniden bağlanmak. Yeni token'ları open_id ile eşleştirin; TikTok'in hesap için uygulamaya özgü kimliği budur. Saklanan kaydı, geçmişini ve ayarlarını koruyarak yerinde güncelleyin.
  • 40103 veya 40107 hatasını aynı yenileme token'ı ile yeniden denemek. İkisi de yeniden denemeyle düzelmez: ilki yeni bir yetkilendirme, ikincisi ise son yanıttaki yenileme token'ı ya da yeni bir yetkilendirme gerektirir.
  • 40100'ü kopmuş bağlantı sanmak. Bu sınırlandırılmış bir çağrıdır; uç noktayı 5 dakika duraklatın ya da günlük sınırdan sonra 00:00 UTC'ye kadar bekleyin. Aynı token çalışmaya devam eder.
Bunu EasyCoexistence'la yapmak

Bağlantı başına aylık US$ 9 ile US$ 0.75 arasında; bağlantı ekledikçe düşer. İlk 3 gün ücretsiz deneme.

Sık sorulan sorular

Hesap sahibi olmadan bir TikTok API bağlantısı süresiz çalışabilir mi?

Hayır. Yenileme, en fazla yenileme token'ının bir yıllık ömrü boyunca bağlantıyı taşır; bundan sonra TikTok'in belgelediği yol, hesap sahibinin yeni bir yetkilendirme yapmasıdır.

Birden çok hesapta TikTok bağlantıları neden aynı anda başarısız oldu?

Hesaplara bakmadan önce uygulamaya bakın: 40113, uygulamanın engellendiği ya da kimliğinin ve sırrının eşleşmediği anlamına gelir; TikTok da kötüye kullanım nedeniyle bir uygulamanın Accounts API erişimini iptal edebilir.

Yeni bir özellik TikTok hesaplarını yeniden bağlamayı gerektirir mi?

Hesap sahibinin hiç vermediği bir kapsam gerektiriyorsa evet. Bir token, yetkilendirmede onaylanan kapsamları korur; bu yüzden bir tane eklemek için hesap sahibinin uygulamayı yeniden yetkilendirmesi gerekir.

Hesabın yeniden bağlanması gerekirken zamanlanmış TikTok gönderilerine ne olur?

easyCoexistence'ta bunlar zamanı geldiğinde TikTok'e ulaşmak yerine reconnect olarak başarısız olur, hesap sahibine e-posta gönderilir ve hesap yeniden bağlandığında Retry bunları gönderir.

Okumaya devam edin

İlk kanalınızı iki dakikada bağlayın.

Beklemeniz gereken platform incelemesi yok. WhatsApp, Instagram, TikTok veya başka bir kanalı bağlayın, ardından yapay zekânızdan paylaşım yapmasını, yanıtlamasını ya da rapor vermesini isteyin ve işini izleyin.

  • 3 gün ücretsiz
  • İstediğiniz zaman iptal
  • Yalnızca resmi API'ler
  • 7/24 izleniyor

Doğrulama tarihi