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

TikTok API for Business erişim token'ları: 24 saat, yenileme ve iptal

Bir TikTok API for Business erişim token'ı 24 saat geçerlidir ve Access-Token başlığıyla taşınır. Uygulama, hesap sahibinin yetkilendirme kodunu /tt_user/oauth2/token/ adresinde takas ederek bu token'ı alır; bir yıl geçerli bir yenileme token'ı da birlikte gelir ve erişimi /tt_user/oauth2/refresh_token/ adresinde yeniler. Token'ı /tt_user/oauth2/revoke/ adresinde iptal edin, verilen kapsamları /tt_user/token_info/get/ adresinde listeleyin.

easyCoexistence, bir TikTok hesabı oturum açtığında kodu takas eder, 24 saatlik token dolmadan yeniler ve hesabı yaklaşık her 6 saatte bir denetler.

24 hours

TikTok hesap erişim token'ının ömrü; her token yanıtı expires_in içinde kalan saniyeyi belirtir.

1 year

Bununla verilen yenileme token'ının geçerlilik süresi; refresh_token_expires_in kalan saniyeyi verir.

10 minutes

Yönlendirmedeki yetkilendirme kodunun ne kadar geçerli kaldığı; yalnızca bir kez takas edilebilir.

open_id

Hesabın uygulamaya özgü kimliği; her token ile birlikte döner ve Accounts API çağrılarında business_id olarak gönderilir.

Bearer

TikTok'un döndürdüğü token_type: token'ı elinde tutan herkes hesabın kaynaklarına erişebilir.

creator_id

/tt_user/token_info/get/ adresinin, token'ın kapsamının yanında döndürdüğü hesap kimliği; Accounts API çağrılarında business_id olarak kullanılabilir.

Yetkilendirme kodu uygulamanıza nasıl ulaşır?

TikTok hesap sahibi yetkilendirme URL'si aracılığıyla. Bu URL, uygulama TikTok Accounts iznini aldığında, TikTok tarafından geliştirici uygulamanızın My Apps, App Detail, Basic Information bölümünde üretilir. Hesap sahibi URL'yi açar, izinleri gözden geçirip onaylar. TikTok ardından tarayıcıyı uygulamanızın yönlendirme URL'sine gönderir; URL'ye auth_code eklenir, yetkilendirme URL'sindeki state değeri de varsa onunla birlikte. Bu kod 10 dakika geçerlidir ve yalnızca bir kez takas edilebilir.

  • Yönlendirme URL'si: mutlak, https:// ile başlayan, / ile biten, sorgu dizisi, çapa veya bağlantı noktası içermeyen ve 10 ila 512 karakter uzunluğunda olmalıdır.
  • Uygulama başına en fazla 10 yönlendirme URL'si; aynı anda biri etkin olur. Bir URL'yi etkinleştirmek, kendi yetkilendirme URL'sini üretir.
  • state: TikTok'un yönlendirmede geri gönderdiği, isteğe bağlı bir değer; CSRF'ye karşı koruma olarak önerilir.
  • disable_auto_auth=1: daha önce aynı izinleri onaylamış sahiplere inceleme sayfasını gösterir; TikTok bunları aksi halde hemen yönlendirir.

Kodu token'lara nasıl takas edersiniz?

Sunucunuzdan, JSON olarak /tt_user/oauth2/token/ adresine POST isteği göndererek. client_id ve client_secret, My Apps, App Detail, Basic Information altında görünen App ID ve Secret değerleridir; grant_type değeri authorization_code olur; auth_code, yönlendirmedeki koddur; redirect_uri ise uygulamada tanımlı TikTok hesap sahibi yönlendirme URL'siyle birebir aynı olmalıdır.

Exchange the authorization code
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/"
  }'

Token yanıtı neleri içerir?

code, message, request_id ve data alanlarını içeren bir JSON nesnesi. code değeri 0 ise takas başarılıdır; data hem iki token'ı hem de hesabın kimliğini taşır:

  • access_token: API çağrıları için kısa ömürlü token, bir gün geçerlidir.
  • token_type: Bearer; TikTok bunun, token'a sahip herkesin kullanabileceği anlamına geldiğini belirtir.
  • scope: token'a verilen izinler, virgülle ayrılmış tek bir metin olarak.
  • expires_in: erişim token'ının sona ermesine kalan saniye; TikTok örneğinde 86400.
  • refresh_token: erişimi yenileyen token, bir yıl geçerlidir; TikTok bunu saklamanızı önerir.
  • refresh_token_expires_in: yenileme token'ının sona ermesine kalan saniye.
  • open_id: TikTok hesabının uygulamaya özgü kimliği.
A token response (scope shortened)
{
  "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>"
  }
}

Token API çağrılarında nasıl gönderilir?

Access-Token adlı bir istek başlığında, /business/get/ ile /business/video/publish/ arasındaki Accounts API uç noktalarında. Hesap ise business_id alanında belirtilir; değeri aynı yanıttaki open_id olur. OAuth uç noktaları ters çalışır: /tt_user/oauth2/token/, /tt_user/oauth2/refresh_token/ ve /tt_user/oauth2/revoke/ uygulamanızın client_id ve client_secret değerlerini JSON gövdesinde alır, Access-Token başlığı almaz.

Erişimi nasıl yenilersiniz?

/tt_user/oauth2/refresh_token/ adresine; client_id, client_secret, grant_type değeri refresh_token ve saklanan refresh_token ile POST isteği göndererek. Yanıt, ilk takasla aynı alanları içerir: expires_in değeriyle yeni bir access_token, bir sonraki yenileme için saklanacak bir refresh_token ve bunun kalan saniyeleri. Yenilemeyi 40102 hatasını beklemek yerine 24 saat dolmadan planlayın.

Renew a TikTok account access token in Python
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"],
    }

Erişimi nasıl iptal edersiniz?

Uygulamadan: client_id, client_secret ve iptal edilecek access_token ile /tt_user/oauth2/revoke/ adresine POST isteği göndererek. Başarıda code değeri 0 ve boş bir data nesnesi döner. Hesaptan: hesap sahibi TikTok uygulamasını açar, Settings and privacy, Security, Manage app permissions yolunu izleyip uygulamayı seçer ve Remove access seçeneğini kullanır. Yetkilendirme iptal edildikten sonra TikTok, o hesap için uygulamaya comment.update olaylarını göndermeyi durdurur.

Revoke a TikTok account access token
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": {}}

Bir token'ı nasıl incelersiniz?

/tt_user/token_info/get/ adresine POST isteği göndererek; bu uç nokta kendi iznini gerektirmez. app_id ve access_token gönderirsiniz; data app_id, scope ve creator_id döndürür. scope, hesap sahibinin verdiği izinleri listeler; creator_id ise hesabın uygulamaya özgü kimliğidir ve Accounts API çağrılarında business_id olarak kullanılan değerdir. TikTok'un referansları, bir alan token'da bulunmayabilecek bir kapsam gerektirdiğinde geliştiricileri buraya yönlendirir.

Token'lardan kaynaklanan hatalar hangileridir?

TikTok bunları yanıtın code alanında döndürür; genellikle HTTP 200 durum koduyla. Bu nedenle bir çağrıya güvenmeden önce code değerini kontrol edin. Token'lar ve takasıyla ilgili dönüş kodları:

  • 40102: access token'ın süresi doldu; yenileyin ve çağrıyı tekrarlayın.
  • 40103: refresh token'ın süresi doldu; yalnızca hesap sahibinin yeniden yetkilendirmesi onu değiştirebilir.
  • 40104: istekte access token yok.
  • 40105: access token geçersiz veya hatalı.
  • 40107: refresh token geçersiz veya hatalı; örneğin hiç sona ermeyen Marketing API token'ını yenilemek için gönderilen bir token.
  • 40110: yetkilendirme kodu iptal edildi, daha önce kullanıldı veya süresi doldu.
  • 40131: iki token uç noktasında kimlik doğrulama hatası; yanlış uygulama ID'si veya secret, süresi dolmuş kod ya da geçersiz veya süresi dolmuş yenileme token'ı nedeniyle.

Ne yeniler easyCoexistence sizin yerinize?

Oturum açmadan sonrası her şeyi. easyCoexistence, TikTok sizi geri yönlendirir yönlendirmez kodu takas eder, iki token'ı da şifreli olarak saklar ve erişim token'ını kendisi yeniler: 15 dakikadan az kaldığında bir çağrıdan önce ve hesap başına yaklaşık her 6 saatte bir çalışan denetimde, 8 saatten az kaldığında. Her yenileme yeni yenileme token'ını ve sona erme zamanını saklar; aynı anda gelen çağrılar tek bir yenilemeyi paylaşır.

  • Reddedilen token: TikTok 40102, 40104 veya 40105 yanıtı verdiğinde bağlantı yeniden bağlanmak üzere işaretlenir ve hesap sahibine e-posta gider; Partner API kullanıcıları ayrıca channel.disconnected olayını alır.
  • Kendi kodunuz: get_social_credentials veya Partner API üzerinde GET /channels/{id}?credentials=1, token_expires_at ile birlikte güncel token'ı döndürür; bu yüzden her iş için ayrı ayrı çekin.
  • Kaldırma: panelden bağlantıyı kaldırmak veya DELETE /channels/{id} kullanmak, token'ı /tt_user/oauth2/revoke/ üzerinden TikTok'ta iptal eder.

Yaygın hatalar

  • Yetkilendirme kodunu tarayıcıda takas etmek. Takas uygulamanın client_secret değerini gönderir; bu yüzden kodu yönlendirmeden sonra 10 dakika içinde sunucunuzdan yapın.
  • expires_in değerini tarih sanmak. Bu değer kalan saniyeyi tutar; token'ın ne zaman sona ereceğini bilmek için yanıtın alındığı zamana ekleyin.
  • Yenileme token'ıyla iptal etmek. /tt_user/oauth2/revoke/ access_token alır; uygulamanın client_id ve client_secret değerleriyle birlikte.
  • Onay ekranının yokluğunu hata saymak. TikTok, hesap sahibinin daha önce onayladığı izinler için inceleme sayfasını atlar; tekrar göstermek için disable_auto_auth=1 ekleyin.
Bunu EasyCoexistence'la yapmak

Böylece Claude, ChatGPT veya kendi kodunuz güncel bir token ile TikTok'u çağırır; get_social_credentials bu token'ı betiklerinize 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 sunulur.

Sık sorulan sorular

TikTok API for Business erişim token'ı ne kadar süre geçerlidir?

24 saat. Her token yanıtı expires_in alanında kalan saniyeyi verir; bir yıl geçerli olan yenileme token'ı ise erişimi yeniler.

TikTok yenileme uç noktası redirect_uri istiyor mu?

Parametre tablosu client_id, client_secret, grant_type ve refresh_token alanlarını listeler, redirect_uri yoktur; ancak TikTok'un kimlik doğrulama rehberi token uç noktalarının redirect_uri istediğini belirtir.

TikTok token'ını iptal etmek webhook'ları durdurur mu?

Evet. Hesap sahibi uygulamayı yeniden yetkilendirene kadar TikTok, o hesap için uygulamaya comment.update olaylarını göndermez.

TikTok business_id değeri nereden gelir?

Token yanıtındaki open_id değerinden; Accounts API çağrıları bunu business_id olarak alır. /tt_user/token_info/get/ aynı kimliği creator_id olarak döndürür.

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