Kirjaudu sisäänAloita ilmainen kokeilu
easyCoexistence Viralliset API:t

TikTok API for Business -scopet: mitä kukin oikeus avaa

TikTok API for Business antaa pääsyn kahdessa kerroksessa. Kehittäjäsovellus pitää oikeudet TikTok Accountsin alla, kuten Video Publish ja Manage Account Comment, ja ne avaavat endpointeja. Tilin omistajan valtuutus antaa tokenille scopet, kuten user.insights ja video.list, ja ne päättävät, mitkä kentät palautuvat. Kutsu /tt_user/token_info/get/ listaa tokenin scopet.

easyCoexistence pyytää TikTok-tilin omistajalta sovelluksensa oikeudet yhdellä kirjautumisella, joten Claude, ChatGPT tai oma koodisi voivat julkaista, hoitaa kommentit ja lukea tilastot sen työkalujen kautta.

18000000

TikTok Accountsin scope-tunnus, ensimmäisen tason oikeus, joka on Accounts API:n profiili-, julkaisu-, kommentti- ja julkaisuendpointtien yläpuolella.

user.account.type

Scope, jonka takana ovat is_business_account ja has_advanced_access tilin profiilitiedoissa.

comment.list

Scope, jonka omistajan on myönnettävä ja pidettävä voimassa, jotta sovellus vastaanottaa comment.update webhook -tapahtumat.

video.upload

Scope, jota token tarvitsee, jotta julkaisun voi ladata luonnoksena julkaisemisen sijaan.

2 to 3 days

Arkipäiviä, joita TikTokin tarkastelu kehittäjäsovelluksen oikeuksien muutoksesta voi kestää.

Mitkä ovat TikTokin oikeuksien kaksi kerrosta?

Sovelluksen oikeudet ja tokenin scopet. Sovelluksen oikeudet valitaan My Apps -näkymässä, sovelluksen kohdalla Scope of permission -osiossa, ja TikTok tarkastaa ne. Niitä on kolme tasoa, ja ensimmäisen tason oikeus kattaa kaikki sen alla olevat endpointit. Tokenien scopet ovat niitä, jotka tilin omistaja hyväksyi sovellusta valtuuttaessaan. Ne palautetaan kentässä scope, pilkuilla erotettuna merkkijonona, jokaisen tokenin mukana. Kutsu tarvitsee sovelluksen oikeuden endpointilleen, ja jotkin vastauksen kentät tarvitsevat lisäksi tokeniin kuuluvan scopen.

Mikä sovelluksen oikeus avaa kunkin endpointin?

TikTokin API-viite listaa jokaiselle Accounts API:n endpointille TikTok Accountsin alla olevan oikeuden, joka avaa sen, tai ei mitään. Sen oikeusviite ja webhook-opas kutsuvat samoja ryhmiä nimillä Business User, Business Media, Business Comment ja Business Content, joten odota molempia nimistöjä:

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

Mitkä tokenin scopet avaavat mitkä kentät?

TikTokin ohjeet kohdille /business/get/ ja /business/video/list/ antavat jokaiselle vastauskentälle vaaditun oikeuden, ja kaksi muuta ominaisuutta nimeävät oman scopensa:

  • user.info.basic: display_name ja profile_image.
  • user.info.username: username, joka vaati user.info.basic-scopen kesäkuuhun 2023 asti.
  • user.info.profile: profile_deep_link, bio_description ja is_verified.
  • user.info.stats: following_count, followers_count, total_likes ja videos_count.
  • user.account.type: is_business_account ja has_advanced_access.
  • user.insights: päivittäiset tilimittarit ja seuraajien erittelyt iän, sukupuolen, maan ja kaupungin mukaan.
  • video.list: julkaisukentät, kuten item_id, caption, share_url, likes, comments, shares, reach ja video_views.
  • video.insights: katseluaika, koko katselun osuus, säilyvyys, liikennelähteet, katsojaerittelyt ja julkaisun tuomat klikkaukset.
  • comment.list: comment.update webhook, jonka TikTok kuvaa sovelluksen sisäisen sisällön kommenttien ja vastausten lukemisena.
  • video.upload: videon tai kuvajulkaisun lataaminen luonnoksena, upload_to_draft tai is_draft.

Miten näet tokenin scopet?

Kysy kutsulla /tt_user/token_info/get/, joka ottaa parametreiksi app_id ja access token ja palauttaa tokenin scope-kentän sekä tilin creator_id:n. TikTokin esimerkkimerkkijonoissa scopeja on myös video.publish ja comment.list.manage, joiden nimet vastaavat julkaisu- ja kommenttien hallinnan endpointteja, vaikka sen viitteet eivät sido niistä kumpaakaan mihinkään kenttään.

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

Mihin easyCoexistence-yhteys pyytää oikeuksia?

Kaikki oikeudet, jotka sen kehittäjäsovellus pitää, ja ne kaikki näkyvät TikTokin suostumussivulla. easyCoexistence lähettää tilin omistajan valtuutus-URL:iin, jonka TikTokin portaali luo sovellukselle. Osoite nimeää jo nuo oikeudet, ja easyCoexistence lisää siihen vain oman state-arvonsa. Omistaja hyväksyy sen, minkä TikTok näyttää, ja TikTokin palauttama scope-merkkijono tallennetaan yhteyden mukana. Endpointit, joita easyCoexistence kutsuu tilin puolesta:

  • /business/get/ profiilille, päivittäisille mittareille ja seuraajaerittelyille.
  • /business/video/list/ julkaisuille ja niiden mittareille.
  • /business/video/publish/, /business/photo/publish/ ja /business/publish/status/ julkaisemiseen.
  • /business/comment/list/, /business/comment/reply/create/, /business/comment/hide/ ja /business/comment/delete/ kommentteihin.
  • /business/webhook/update/, sovellustasolla, kommentti-webhookille.

Miten lisäät oikeuden myöhemmin?

Kahdessa vaiheessa, yksi kummallekin tasolle. Sovelluksen osalta avaa My Apps, valitse sovellus, sitten Scope of permission, muokkaa sitä, anna perustelu, joka vastaa uusia scopeja, ja lähetä pyyntö. TikTokin tarkastelu voi kestää kaksi–kolme arkipäivää, ja 20. maaliskuuta 2026 lähtien pyyntö, joka sisältää TikTok Accountsin, vaatii ensin Accounts API Access Application Form -lomakkeen. Tokenin osalta omistaja valtuuttaa sovelluksen uudelleen, koska token säilyttää ne scopet, jotka hyväksyttiin sen myöntämishetkellä.

Mitä tapahtuu, kun oikeus puuttuu?

Kutsun osalta TikTokin paluukoodi on 40001, ei oikeutta suorittaa siihen liittyvää toimintoa, ja sen korjausohje osoittaa oikeusviitteeseen. Kentän osalta viitteet tekevät sen saatavilla vasta, kun omistaja on myöntänyt sen scopen, ja niiden korjaus on, että omistaja valtuuttaa sovelluksen uudelleen kyseisellä scopella. Tarkista tokenin scope kutsulla /tt_user/token_info/get/ ennen kuin pyydät omistajaa.

Yleiset virheet

  • Odotat, että yhdistetyt tilit saavat uuden sovelluksen oikeuden itsestään. Niiden tokenit säilyttävät valtuutuksessa hyväksytyt scopet, kunnes kukin omistaja valtuuttaa sovelluksen uudelleen.
  • Pyydät is_business_account-kenttää ilman user.account.type-scopea. TikTok tekee kentän ja has_advanced_access-kentän saatavilla vain tokeneille, joilla on se scope.
  • Odotat comment.update-tapahtumia ilman comment.list-scopea. TikTok lähettää kommenttitapahtumat vain silloin, kun omistajan valtuutus kyseisellä scopella on voimassa.
  • Etsit tokenista sovelluksen oikeuksien nimiä. Scope-merkkijono käyttää nimiä kuten video.list, kun taas nimet kuten Get Account Media kuuluvat sovelluksen asetuksiin.
Näin teet tämän EasyCoexistencen avulla

get_social_credentials antaa omalle koodillesi saman tokenin muita Accounts API:n endpointeja varten. US$ 9:stä US$ 0,75:een yhteydeltä kuukaudessa, hinta laskee yhteyksien määrän kasvaessa, ja ensimmäiset 3 päivää ovat ilmaista kokeilua.

Usein kysytyt kysymykset

Mitä scopeja TikTok API for Business käyttää?

Tokenin scopeja, kuten user.info.basic, user.info.stats, user.insights, video.list, video.insights, comment.list ja video.upload. Tilin omistaja myöntää ne sovelluksen TikTok Accountsin oikeuksien lisäksi.

Mitä oikeuksia TikTokin kommentti-webhook tarvitsee?

Sovellus tarvitsee TikTok Accountsin ja Business Commentin, ja omistajan on myönnettävä comment.list. Tapahtumat loppuvat, jos tuo valtuutus vanhenee tai se peruutetaan.

Koskeeko uusi TikTok-scope jo myönnettyjä tokeneita?

Ei. Token säilyttää ne scopet, jotka hyväksyttiin sen myöntämishetkellä, joten tilin omistaja valtuuttaa sovelluksen uudelleen lisätäkseen uuden scopen.

Kuinka kauan TikTokilta kestää hyväksyä uusi oikeus?

TikTokin mukaan oikeusmuutoksen tarkastelu voi kestää kaksi–kolme arkipäivää, ja pyynnöt, jotka lisäävät ensin TikTok Accountsin, vaativat Accounts API Access Application Form -lomakkeen.

Lue lisää

Yhdistä ensimmäinen kanavasi kahdessa minuutissa.

Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.

  • 3 päivää ilmaiseksi
  • Peruuta milloin tahansa
  • Vain viralliset API:t
  • Valvottu 24/7

Vahvistettu