Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

TikTok API for Business: zakresy i co odblokowuje każde uprawnienie

API for Business TikToka przyznaje dostęp na dwóch warstwach. Aplikacja deweloperska ma uprawnienia w obszarze TikTok Accounts, takie jak Video Publish i Manage Account Comment, które otwierają endpointy. Autoryzacja właściciela konta nadaje tokenowi dostępu zakresy, takie jak user.insights i video.list, które decydują o tym, jakie pola są zwracane. /tt_user/token_info/get/ wyświetla listę zakresów, które posiada token.

easyCoexistence prosi właściciela konta TikTok o uprawnienia, które trzyma jego aplikacja, jednym logowaniem, aby Claude, ChatGPT lub twój własny kod mogły publikować, pracować z komentarzami i odczytywać statystyki przez jego narzędzia, a get_social_credentials daje twojemu własnemu kodowi ten sam token do innych endpointów Accounts API.

18000000

Identyfikator zakresu TikTok Accounts, uprawnienia pierwszego poziomu nad endpointami Accounts API dla profilu, postów, komentarzy i publikowania.

user.account.type

Zakres stojący za is_business_account i has_advanced_access w danych profilu konta.

comment.list

Zakres, który właściciel musi przyznać i utrzymać aktywnym, aby aplikacja otrzymywała zdarzenia webhooka comment.update.

video.upload

Zakres potrzebny tokenowi, aby przesłać post jako wersję roboczą zamiast go publikować.

2 to 3 days

Dni robocze, które może zająć przegląd przez TikToka zmiany uprawnień aplikacji deweloperskiej.

Jakie są dwie warstwy uprawnień TikToka?

Uprawnienia aplikacji i zakresy tokenu. Uprawnienia aplikacji wybiera się w My Apps, w aplikacji, w sekcji Scope of permission, a TikTok je sprawdza. Występują na trzech poziomach, a uprawnienie pierwszego poziomu obejmuje wszystkie endpointy niżej. Zakresy tokenu to to, co właściciel konta zatwierdził przy autoryzacji aplikacji, zwracane jako scope, jeden ciąg rozdzielony przecinkami, przy każdym tokenie. Wywołanie wymaga uprawnienia aplikacji do swojego endpointu, a niektóre pola odpowiedzi wymagają także zakresu na tokenie.

Które uprawnienie aplikacji otwiera każdy endpoint?

Dokumentacja API TikToka wymienia dla każdego endpointu Accounts API uprawnienie w obszarze TikTok Accounts, które go otwiera, albo żadne. Jej przewodnik po zakresach uprawnień i przewodnik po webhookach nazywają te same grupy Business User, Business Media, Business Comment i Business Content, więc spodziewaj się obu zestawów nazw:

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

Które zakresy tokenu odblokowują które pola?

Opisy /business/get/ i /business/video/list/ w dokumentacji TikToka podają wymagane uprawnienie dla każdego pola odpowiedzi, a dwie inne funkcje mają własny zakres:

  • user.info.basic: display_name i profile_image.
  • user.info.username: username, które do czerwca 2023 roku wymagało user.info.basic.
  • user.info.profile: profile_deep_link, bio_description i is_verified.
  • user.info.stats: following_count, followers_count, total_likes i videos_count.
  • user.account.type: is_business_account i has_advanced_access.
  • user.insights: dzienne metryki konta oraz rozkłady obserwujących według wieku, płci, kraju i miasta.
  • video.list: pola postów, takie jak item_id, caption, share_url, likes, comments, shares, reach i video_views.
  • video.insights: czas oglądania, wskaźnik pełnego obejrzenia, retencja, źródła ruchu, rozkłady widzów oraz kliknięcia, jakie generuje post.
  • comment.list: webhook comment.update, który TikTok opisuje jako odczyt komentarzy i odpowiedzi do treści w aplikacji.
  • video.upload: przesyłanie posta wideo lub zdjęcia jako wersji roboczej, z upload_to_draft lub is_draft.

Jak sprawdzić zakresy na tokenie?

Zapytaj /tt_user/token_info/get/, który przyjmuje app_id oraz token dostępu i zwraca scope tokenu oraz creator_id konta. Przykładowe ciągi zakresów w dokumentacji TikToka zawierają też video.publish i comment.list.manage, których nazwy pasują do endpointów publikowania i zarządzania komentarzami, choć dokumentacja nie przypisuje żadnego pola do żadnego z nich.

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"
  }
}

Czego wymaga połączenie TikTok easyCoexistence?

Uprawnień, które trzyma jego aplikacja deweloperska, wszystkich pokazanych na ekranie zgody TikToka. easyCoexistence wysyła właściciela konta pod adres URL autoryzacji posiadacza konta TikTok, który portal TikToka generuje dla aplikacji i który już wymienia te uprawnienia, i dodaje tylko własną wartość state. Właściciel zatwierdza to, co pokazuje TikTok, a zwrócony przez TikToka ciąg scope jest zapisywany przy połączeniu. Endpointy, które easyCoexistence następnie wywołuje dla konta:

  • /business/get/ dla profilu, dziennych metryk i rozkładów obserwujących.
  • /business/video/list/ dla postów i ich metryk.
  • /business/video/publish/, /business/photo/publish/ i /business/publish/status/ do publikowania.
  • /business/comment/list/, /business/comment/reply/create/, /business/comment/hide/ i /business/comment/delete/ dla komentarzy.
  • /business/webhook/update/, na poziomie aplikacji, dla webhooka komentarzy.

Jak dodać uprawnienie później?

W dwóch krokach, po jednym na każdą warstwę. Dla aplikacji otwórz My Apps, aplikację, Scope of permission, edytuj, podaj powód zgodny z nowymi zakresami i wyślij. Przegląd TikToka może zająć dwa do trzech dni roboczych, a od 20 marca 2026 roku żądanie obejmujące TikTok Accounts wymaga najpierw formularza Accounts API Access Application Form. Dla tokenu właściciel autoryzuje aplikację ponownie, ponieważ token zachowuje zakresy zatwierdzone w chwili jego wydania.

Co się dzieje, gdy brakuje uprawnienia?

Przy wywołaniu kod błędu TikToka to 40001, brak uprawnienia do wykonania powiązanej operacji, a jego poprawka wskazuje na dokumentację zakresów uprawnień. Przy polu dokumentacja udostępnia je dopiero po przyznaniu zakresu przez właściciela, a jej poprawką jest ponowna autoryzacja aplikacji przez właściciela z tym zakresem. Zanim o to poprosisz, sprawdź zakres tokenu przez /tt_user/token_info/get/.

Typowe błędy

  • Oczekiwanie, że połączone konta same zyskają nowe uprawnienie aplikacji. Ich tokeny zachowują zakresy zatwierdzone przy autoryzacji, aż każdy właściciel autoryzuje aplikację ponownie.
  • Żądanie is_business_account bez user.account.type. TikTok udostępnia to pole oraz has_advanced_access tylko tokenom z tym zakresem.
  • Czekanie na comment.update bez comment.list. TikTok wysyła zdarzenia komentarzy tylko wtedy, gdy autoryzacja właściciela z tym zakresem pozostaje ważna.
  • Szukanie w tokenie nazw uprawnień aplikacji. Ciąg scope używa nazw takich jak video.list, a nazwy takie jak Get Account Media należą do ustawień aplikacji.
Z EasyCoexistence zrobisz to

Od US$ 9 do US$ 0,75 za połączenie miesięcznie, tańsze w miarę dodawania połączeń, z pierwszymi 3 dniami bezpłatnie.

Najczęściej zadawane pytania

Jakich zakresów używa TikTok API for Business?

Zakresów tokenu, takich jak user.info.basic, user.info.stats, user.insights, video.list, video.insights, comment.list i video.upload, przyznawanych przez właściciela konta ponad uprawnieniami aplikacji w obszarze TikTok Accounts.

Jakich uprawnień potrzebuje webhook komentarzy TikToka?

Aplikacja potrzebuje TikTok Accounts oraz Business Comment, a właściciel musi przyznać comment.list. Zdarzenia przestają przychodzić, gdy ta autoryzacja wygaśnie lub zostanie cofnięta.

Czy nowy zakres TikToka dotyczy tokenów już wydanych?

Nie. Token zachowuje zakresy zatwierdzone w chwili wydania, więc właściciel konta autoryzuje aplikację ponownie, aby dodać nowy.

Ile TikTok potrzebuje czasu na zatwierdzenie nowego uprawnienia?

TikTok podaje, że przegląd zmiany uprawnienia może zająć dwa do trzech dni roboczych, a żądania dodające TikTok Accounts wymagają najpierw formularza Accounts API Access Application Form.

Czytaj dalej

Połącz pierwszy kanał w dwie minuty.

Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.

  • 3 dni za darmo
  • Rezygnacja w każdej chwili
  • Tylko oficjalne API
  • Monitorowanie 24/7

Zweryfikowano w