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

TikTok API for Business kapsamları: her izin neyi açar

TikTok'un API for Business'ı erişimi iki katmanda verir. Geliştirici uygulaması, TikTok Accounts altında Video Publish ve Manage Account Comment gibi izinleri tutar ve bunlar uç noktaları açar. Hesap sahibinin yetkilendirmesi ise erişim token'ına user.insights ve video.list gibi kapsamlar verir ve hangi alanların döndüğünü belirler. /tt_user/token_info/get/ bir token'ın taşıdığı kapsamları listeler.

easyCoexistence, TikTok hesap sahibinden uygulamasının sahip olduğu izinleri tek bir oturum açmada ister.

18000000

TikTok Accounts'un kapsam kimliği, Accounts API'nin profil, gönderi, yorum ve yayınlama uç noktalarının üstündeki birinci düzey izindir.

user.account.type

Hesabın profil verisindeki is_business_account ve has_advanced_access alanlarının arkasındaki kapsam.

comment.list

Uygulamanın comment.update webhook olaylarını alması için hesap sahibinin vermesi ve aktif tutması gereken kapsam.

video.upload

Bir gönderiyi yayınlamak yerine taslak olarak yüklemek için token'ın ihtiyaç duyduğu kapsam.

2 to 3 days

TikTok'un bir geliştirici uygulamasının izinlerindeki değişikliği incelemesinin alabileceği iş günü sayısı.

TikTok izinlerinin iki katmanı nelerdir?

Uygulama izinleri ve token kapsamları. Uygulama izinleri, My Apps altında uygulamanın Scope of permission bölümünden seçilir ve TikTok bunları inceler. Üç düzeyde gelirler ve birinci düzey bir izin, altındaki her uç noktayı kapsar. Token kapsamları, hesap sahibinin uygulamayı yetkilendirirken onayladığı şeylerdir ve her token ile birlikte virgülle ayrılmış tek bir dize olarak scope içinde döner. Bir çağrının, uç noktası için uygulamanın iznine ihtiyacı vardır; bazı yanıt alanları ise token üzerinde bir scope de gerektirir.

Hangi uygulama izni her uç noktayı açar?

TikTok'un API referansı, her Accounts API uç noktası için onu açan TikTok Accounts altındaki izni ya da none değerini listeler. İzin kapsamı referansı ve webhook kılavuzu aynı grupları Business User, Business Media, Business Comment ve Business Content olarak adlandırır; bu yüzden iki isim kümesini de bekleyin:

Account User/business/get/: profile data and account insights
Get Account Media/business/video/list/: the account's posts and their metrics
Video Publish/business/video/publish/, /business/publish/status/, /business/video/settings/, hashtag suggestions and location tags
Photo Publish/business/photo/publish/
Get Business Comment/business/comment/list/ and /business/comment/reply/list/
Manage Account CommentCreating, replying to, liking, hiding and deleting comments, and comment image uploads
Business Benchmark/business/benchmark/: benchmarks for a business category
No permission needed/tt_user/token_info/get/, the URL property endpoints and the webhook configuration endpoints

Hangi token kapsamları hangi alanların kilidini açar?

TikTok'un /business/get/ ve /business/video/list/ referansları her yanıt alanı için gereken izni verir; iki başka özellik ise kendi scope'unu adlandırır:

  • user.info.basic: display_name ve profile_image.
  • user.info.username: username; Haziran 2023'e kadar user.info.basic gerektiriyordu.
  • user.info.profile: profile_deep_link, bio_description ve is_verified.
  • user.info.stats: following_count, followers_count, total_likes ve videos_count.
  • user.account.type: is_business_account ve has_advanced_access.
  • user.insights: günlük hesap metrikleri ile yaşa, cinsiyete, ülkeye ve şehre göre takipçi dökümleri.
  • video.list: item_id, caption, share_url, likes, comments, shares, reach ve video_views gibi gönderi alanları.
  • video.insights: izlenme süresi, tam izlenme oranı, elde tutma, trafik kaynakları, izleyici dökümleri ve bir gönderinin sağladığı tıklamalar.
  • comment.list: comment.update webhook'u; TikTok bunu uygulama içi içeriğin yorum ve yanıtlarını okumak olarak tanımlar.
  • video.upload: upload_to_draft ya da is_draft ile bir video ya da fotoğraf gönderisini taslak olarak yükleme.

Bir token'daki kapsamları nasıl görürsünüz?

/tt_user/token_info/get/ uç noktasını sorgulayın; bu uç nokta app_id ve erişim token'ını alır, token'ın scope değerini ile hesabın creator_id değerini döndürür. TikTok'un örnek scope dizeleri ayrıca video.publish ve comment.list.manage içerir. Bu adlar yayınlama ve yorum yönetimi uç noktalarıyla eşleşir, ancak TikTok referansları hiçbirini bir alanla ilişkilendirmez.

Read the scopes an access token carries
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/tt_user/token_info/get/' \
  -H 'Content-Type: application/json' \
  -d '{"app_id": "<APP_ID>", "access_token": "<ACCESS_TOKEN>"}'

{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "app_id": "<APP_ID>",
    "creator_id": "<OPEN_ID>",
    "scope": "video.publish,user.info.basic,video.list,user.insights,comment.list.manage,video.insights,comment.list"
  }
}

easyCoexistence'ın TikTok bağlantısı neyi ister?

Geliştirici uygulamasının sahip olduğu izinleri ister; hepsi TikTok'un onay sayfasında gösterilir. easyCoexistence, hesap sahibini TikTok portalının uygulaması için ürettiği ve zaten bu izinleri adlandıran account holder authorization URL'sine yönlendirir ve yalnızca kendi state değerini ekler. Sahip, TikTok'un gösterdiğini onaylar; TikTok'un döndürdüğü scope dizesi bağlantıyla birlikte saklanır. easyCoexistence'ın hesap için sonra çağırdığı uç noktalar:

  • /business/get/: profil, günlük metrikler ve takipçi dökümleri için.
  • /business/video/list/: gönderiler ve metrikleri için.
  • /business/video/publish/, /business/photo/publish/ ve /business/publish/status/: yayınlama için.
  • /business/comment/list/, /business/comment/reply/create/, /business/comment/hide/ ve /business/comment/delete/: yorumlar için.
  • /business/webhook/update/, uygulama düzeyinde, yorum webhook'u için.

Daha sonra bir izin nasıl eklenir?

İki adımda, her katman için bir tane. Uygulama için My Apps, uygulama, Scope of permission bölümünü açın, düzenleyin, yeni kapsamlara uyan bir gerekçe yazın ve gönderin. TikTok'un incelemesi iki ila üç iş günü sürebilir ve 20 Mart 2026'dan beri TikTok Accounts içeren bir istek önce Accounts API Access Application Form gerektirir. Token için sahip uygulamayı yeniden yetkilendirir, çünkü bir token verildiği anda onaylanan kapsamları korur.

Bir izin eksikse ne olur?

Bir çağrı için TikTok'un dönüş kodu 40001'dir: ilgili işlemi gerçekleştirmek için izin yok. Düzeltmesi izin kapsamı referansına işaret eder. Bir alan için referanslar, alanı yalnızca sahip ilgili scope'u verdikten sonra kullanılabilir kılar; düzeltmeleri, sahibin uygulamayı o scope ile yeniden yetkilendirmesidir. Sormadan önce /tt_user/token_info/get/ ile token'ın scope değerini kontrol edin.

Yaygın hatalar

  • Bağlı hesapların kendiliğinden yeni bir uygulama izni kazanmasını beklemek. Token'ları, her sahip uygulamayı yeniden yetkilendirene kadar yetkilendirme sırasında onaylanan kapsamları korur.
  • is_business_account'u user.account.type olmadan istemek. TikTok bu alanı ve has_advanced_access'i yalnızca bu kapsamı taşıyan token'lara açık tutar.
  • comment.list olmadan comment.update'i beklemek. TikTok yorum olaylarını yalnızca sahibin o kapsamla yetkilendirmesi geçerli kaldığı sürece gönderir.
  • Uygulama izni adlarını token'da aramak. Scope dizesi video.list gibi adlar kullanır; Get Account Media gibi adlar ise uygulamanın ayarlarına aittir.
Bunu EasyCoexistence'la yapmak

Böylece Claude, ChatGPT ya da kendi kodunuz yayınlayabilir, yorumlarla çalışabilir ve içgörüleri araçları üzerinden okuyabilir; get_social_credentials ise kendi kodunuza diğer Accounts API uç noktaları için aynı token'ı verir. Bağlantı başına aylık US$ 9 ile US$ 0,75 arasında, bağlantı ekledikçe düşer; ilk 3 gün ücretsiz deneme.

Sık sorulan sorular

TikTok API for Business hangi kapsamları kullanır?

TikTok Accounts izinlerinin üzerine hesap sahibinin verdiği user.info.basic, user.info.stats, user.insights, video.list, video.insights, comment.list ve video.upload gibi token kapsamları.

TikTok'un yorum webhook'u hangi izinlere ihtiyaç duyar?

Uygulamanın TikTok Accounts ve Business Comment izinleri olmalı; sahip de comment.list kapsamını vermelidir. Bu yetkilendirme sona erer ya da iptal edilirse olaylar durur.

Yeni bir TikTok kapsamı, önceden verilmiş token'lara uygulanır mı?

Hayır. Bir token verildiği anda onaylanan kapsamları korur; bu yüzden yeni bir kapsam eklemek için hesap sahibinin uygulamayı yeniden yetkilendirmesi gerekir.

TikTok yeni bir izni onaylamak için ne kadar süre alır?

TikTok, izin değişikliğinin incelemesinin iki ila üç iş günü sürebileceğini söyler. TikTok Accounts'u ekleyen istekler ise önce Accounts API Access Application Form gerektirir.

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