Log masukMulakan percubaan percuma
easyCoexistence API rasmi

Skop TikTok API for Business: apa yang dibuka oleh setiap kebenaran

Dalam API for Business, TikTok memberi akses dalam dua lapisan. Aplikasi pembangun memegang kebenaran di bawah TikTok Accounts, seperti Video Publish dan Manage Account Comment, yang membuka endpoint. Kebenaran pemilik akaun memberi skop token akses, seperti user.insights dan video.list, yang menentukan medan yang dipulangkan. /tt_user/token_info/get/ menyenaraikan skop yang dibawa oleh token.

easyCoexistence meminta pemilik akaun TikTok bagi kebenaran aplikasinya dalam satu kali log masuk, supaya Claude, ChatGPT atau kod anda sendiri boleh menerbitkan, mengurus komen dan membaca analitik melalui alatnya, dan get_social_credentials memberikan kod anda sendiri token yang sama untuk endpoint Accounts API yang lain.

18000000

ID skop TikTok Accounts, kebenaran peringkat pertama di atas profil, siaran, komen dan endpoint penerbitan Accounts API.

user.account.type

Skop di sebalik is_business_account dan has_advanced_access dalam data profil akaun.

comment.list

Skop yang mesti diberi pemilik, dan kekal aktif, supaya aplikasi menerima acara webhook comment.update.

video.upload

Skop yang diperlukan token untuk memuat naik siaran sebagai draf dan bukan menerbitkannya.

2 to 3 days

Hari perniagaan yang mungkin diambil TikTok untuk menyemak perubahan kebenaran aplikasi pembangun.

Apakah dua lapisan kebenaran TikTok?

Kebenaran aplikasi dan skop token. Kebenaran aplikasi dipilih di bawah My Apps, aplikasi itu, Scope of permission, dan TikTok menyemaknya; ia datang dalam tiga peringkat, dan kebenaran peringkat pertama meliputi setiap endpoint di bawahnya. Skop token ialah apa yang diluluskan pemilik akaun ketika memberi kuasa kepada aplikasi, dikembalikan sebagai scope, satu rentetan dipisahkan koma, bersama setiap token. Satu panggilan memerlukan kebenaran aplikasi bagi endpointnya, dan sesetengah medan respons juga memerlukan skop pada token.

Kebenaran aplikasi mana yang membuka setiap endpoint?

Rujukan API TikTok menyenaraikan, bagi setiap endpoint Accounts API, kebenaran di bawah TikTok Accounts yang membukanya, atau tiada. Rujukan skop kebenaran dan panduan webhook TikTok menamakan kumpulan yang sama Business User, Business Media, Business Comment dan Business Content, jadi jangkakan kedua-dua set nama:

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

Skop token mana yang membuka medan mana?

Rujukan TikTok bagi /business/get/ dan /business/video/list/ memberikan kebenaran yang diperlukan bagi setiap medan respons, dan dua ciri lain menamakan skop tersendiri:

  • user.info.basic: display_name dan profile_image.
  • user.info.username: username, yang memerlukan user.info.basic sehingga Jun 2023.
  • user.info.profile: profile_deep_link, bio_description dan is_verified.
  • user.info.stats: following_count, followers_count, total_likes dan videos_count.
  • user.account.type: is_business_account dan has_advanced_access.
  • user.insights: metrik harian akaun dan pecahan pengikut mengikut umur, jantina, negara dan bandar.
  • video.list: medan siaran seperti item_id, caption, share_url, likes, comments, shares, reach dan video_views.
  • video.insights: masa tontonan, kadar tontonan penuh, pengekalan, sumber trafik, pecahan penonton dan klik yang dihasilkan siaran.
  • comment.list: webhook comment.update, yang digambarkan oleh TikTok sebagai membaca komen dan balasan kandungan dalam aplikasi.
  • video.upload: memuat naik siaran video atau foto sebagai draf, dengan upload_to_draft atau is_draft.

Bagaimana melihat skop pada token?

Panggil /tt_user/token_info/get/, yang menerima app_id dan access token serta memulangkan scope token dan creator_id akaun. Contoh rentetan skop TikTok turut menyertakan video.publish dan comment.list.manage, yang namanya sepadan dengan endpoint penerbitan dan pengurusan komen, walaupun rujukannya tidak mengaitkan sebarang medan dengan kedua-duanya.

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

Apakah yang diminta sambungan TikTok easyCoexistence?

Kebenaran yang dipegang aplikasi pembangunnya, semuanya ditunjukkan pada halaman persetujuan TikTok. easyCoexistence menghantar pemilik akaun ke URL kebenaran pemegang akaun TikTok yang dijana oleh portal TikTok untuk aplikasinya, yang sudah menamakan kebenaran tersebut, dan hanya menambah nilai state sendiri. Pemilik meluluskan apa yang ditunjukkan TikTok, dan rentetan skop yang TikTok pulangkan disimpan bersama sambungan itu. Endpoint yang kemudian dipanggil easyCoexistence bagi akaun:

  • /business/get/ bagi profil, metrik harian dan pecahan pengikut.
  • /business/video/list/ bagi siaran dan metriknya.
  • /business/video/publish/, /business/photo/publish/ dan /business/publish/status/ bagi penerbitan.
  • /business/comment/list/, /business/comment/reply/create/, /business/comment/hide/ dan /business/comment/delete/ bagi komen.
  • /business/webhook/update/, di peringkat aplikasi, bagi webhook komen.

Bagaimana menambah kebenaran kemudian?

Dalam dua langkah, satu bagi setiap lapisan. Bagi aplikasi, buka My Apps, aplikasi itu, Scope of permission, sunting, beri sebab yang sepadan dengan skop baharu dan hantar; semakan TikTok mungkin mengambil dua hingga tiga hari perniagaan, dan sejak 20 Mac 2026 permintaan yang merangkumi TikTok Accounts perlu Borang Permohonan Akses Accounts API dahulu. Bagi token, pemilik membenarkan aplikasi sekali lagi, kerana token mengekalkan skop yang diluluskan ketika ia dikeluarkan.

Apa berlaku apabila kebenaran tiada?

Bagi panggilan, kod pulangan TikTok ialah 40001, tiada kebenaran untuk melaksanakan operasi berkaitan, dan pembetulannya menunjuk ke rujukan skop kebenaran. Bagi medan, rujukan menjadikannya tersedia hanya selepas pemilik memberikan skopnya, dan pembetulan mereka ialah meminta pemilik membenarkan aplikasi sekali lagi dengan skop itu. Semak skop token dengan /tt_user/token_info/get/ sebelum bertanya.

Kesilapan biasa

  • Menjangka akaun yang disambungkan memperoleh kebenaran aplikasi baharu dengan sendirinya. Token mereka mengekalkan skop yang diluluskan semasa kebenaran sehingga setiap pemilik membenarkan aplikasi sekali lagi.
  • Meminta is_business_account tanpa user.account.type. TikTok hanya menyediakan medan itu dan has_advanced_access kepada token yang membawa skop tersebut.
  • Menunggu comment.update tanpa comment.list. TikTok hanya menghantar acara komen selagi kebenaran pemilik dengan skop itu masih sah.
  • Mencari nama kebenaran aplikasi dalam token. Rentetan skop menggunakan nama seperti video.list, manakala nama seperti Get Account Media tergolong dalam tetapan aplikasi.
Menggunakan EasyCoexistence untuk ini

Daripada US$ 9 hingga US$ 0.75 setiap sambungan sebulan, menurun apabila anda menambah sambungan, dengan 3 hari pertama percuma.

Soalan lazim

Apakah skop yang digunakan TikTok API for Business?

Skop token seperti user.info.basic, user.info.stats, user.insights, video.list, video.insights, comment.list dan video.upload, yang diberikan pemilik akaun di atas kebenaran TikTok Accounts aplikasi.

Kebenaran apa yang diperlukan oleh webhook komen TikTok?

Aplikasi memerlukan TikTok Accounts dan Business Comment, dan pemilik mesti memberikan comment.list. Acara berhenti jika kebenaran itu tamat tempoh atau dibatalkan.

Adakah skop TikTok baharu terpakai pada token yang sudah dikeluarkan?

Tidak. Token mengekalkan skop yang diluluskan ketika ia dikeluarkan, jadi pemilik akaun membenarkan aplikasi sekali lagi untuk menambah skop baharu.

Berapa lama TikTok mengambil masa untuk meluluskan kebenaran baharu?

TikTok menyatakan semakan perubahan kebenaran mungkin mengambil dua hingga tiga hari perniagaan, dan permintaan yang menambah TikTok Accounts perlu Borang Permohonan Akses Accounts API dahulu.

Teruskan membaca

Sambungkan saluran pertama anda dalam masa dua minit.

Tidak perlu menunggu semakan platform. Sambungkan WhatsApp, Instagram, TikTok atau saluran lain, kemudian minta AI anda menyiarkan, membalas atau melaporkan, dan lihat ia bekerja.

  • 3 hari percuma
  • Batal bila-bila masa
  • API rasmi sahaja
  • Dipantau 24/7

Disahkan pada