TikTok API:n nopeusrajoitukset: pyynnöt tiliä, sovellusta ja endpointia kohden
TikTokin API for Business rajoittaa kutsuja samanaikaisesti kolmella tasolla: 40 minuutissa valtuutettua tiliä kohden Accounts API:n jokaisessa endpointissa, Accounts API:n yhteinen budjetti sovellusta kohden 600 minuutissa Basic-tasolla ja 1 000 ylemmillä tasoilla sekä endpointikohtaiset sovellusrajat: 10 sekunnissa, 600 minuutissa ja 864 000 päivässä Basic-tasolla, nousten Ultimate-tasolla 50 sekunnissa.
easyCoexistence julkaisee TikTokiin julkaisuja, lukee tilastoja ja vastaa kommentteihin Claudelle, ChatGPT:lle tai omalle koodillesi TikTokin API for Business -rajapinnan kautta, palauttaa TikTokin koodin ja viestin, kun kutsu rajoitetaan, ja seuraa jokaista julkaisua, kunnes TikTok saa sen valmiiksi tai se epäonnistuu.
Kyselyitä minuutissa valtuutettua TikTok-tiliä kohden jokaisessa Accounts API:n endpointissa, yksi luku sovelluksen tasosta riippumatta.
Budjetti kaikille Accounts API:n endpointeille yhteensä sovellusta kohden tasoilla Advanced, Premium ja Ultimate; Basic saa 600.
Endpointkohtainen raja Ultimate-tasolla, korkeimmalla sovellustasolla, 3 000 kyselyn minuutissa ja 4 320 000 päivässä rinnalla.
Tila, jonka TikTok palauttaa paluukoodiensa rinnalla, 4xxxx-koodit kuten 40100 mukaan lukien; vain koodi 0 tarkoittaa onnistumista.
Nopeusraja jokaiselle Discovery API:n endpointille sovellusta kohden.
Milloin päivittäiset rajat nollautuvat; minuuttirajan jälkeen TikTok pyytää sen sijaan 5 minuutin taukoa.
Mitkä rajat koskevat TikTok API:n kutsua?
Jokaisen Accounts API -kutsun yhteydessä liikkuu enintään kolme laskuria, ja jotkin tuotteet ja toiminnot pitävät omia laskureitaan. TikTok pitää endpoint-laskurit toisistaan riippumattomina, joten yksi endpoint voi olla rajoitettu, kun sovelluksen muut endpointit yhä vastaavat:
Mitä neljä sovellustasoa sallivat?
Kaikki kehittäjäsovellukset alkavat Basic-tasolta, ja TikTok nostaa sovelluksen yhden tason kerrallaan, kun sitä pyydetään kohdassa My Apps, App Detail, Authorization perusteluineen. Jokainen taso asettaa, mitä yksi endpoint voi saada sovellukselta, Accounts API -kutsujen yhteisen budjetin rinnalla:
Nostaako korkeampi taso Accounts API -budjettia?
Kerran. Basicista Advancediin siirtyminen nostaa Accounts API -kutsujen yhteistä budjettia 600:sta 1 000 kyselyyn minuutissa, ja se pysyy 1 000:ssa Premium- ja Ultimate-tasolla, kun endpointikohtaiset rajat sekunnille ja päivälle kasvavat edelleen. Raja 40 minuutissa tiliä ja endpointia kohden ei muutu tason mukaan lainkaan, joten yksi kiireinen tili rajoitetaan 40 kutsuun minuutissa endpointilla, millä tasolla sovellus sitten onkin.
Miten rajat kertyvät useille tileille?
Tilirajat kertautuvat jokaisella tilillä, sovellusbudjetti ei. Kymmenen tiliä voi tehdä kukin 40 kutsua minuutissa kohteeseen /business/comment/list/, eli yhteensä 400, mutta kaksikymmentä samaa tekevää tarvitsisi 800, mikä on yli sen 600:n, jonka Basic-sovellus saa Accounts API -kutsuilleen yhteensä ennen muiden endpointien laskemista. Basicin yläpuolella yhteinen budjetti nousee enintään 1 000 minuutissa.
Mitä tapahtuu, kun kutsu ylittää rajan?
TikTok rajoittaa kyseisen endpointin. Sen nopeusrajoitusten opas nimeää koodin 40100 rajoitetulle kutsulle, ja se saapuu HTTP 200 -vastauksen sisällä. Endpoint pysyy suljettuna 5 minuuttia minuuttirajan jälkeen tai kunnes päivittäiset laskurit nollautuvat klo 00:00 UTC päivärajan jälkeen, kun sovelluksen muut endpointit vastaavat yhä. Sen tunnistaminen koodissa ja hyvä uudelleenyritys kuuluvat virhekoodiin 40100.
Ovatko julkaisurajat nopeusrajoituksia?
Eivät. Ne laskevat julkaisuja eivätkä kutsuja, ja niillä on oma sivunsa. TikTok sallii tilin julkaista kuusi julkaisua minuutissa ja 15 päivässä endpointin /business/video/publish/ kautta, ja sama koskee endpointia /business/photo/publish/. Julkaisu, joka ylittää tämän määrän, epäonnistuu tilalla spam_risk_too_many_posts julkaisun tilassa, kun taas pyyntörajoitus kieltäytyy itse kutsusta.
Mitkä tavat kuluttavat rajat nopeimmin?
Pollaus. Julkaisutilan tai kommenttilistan tarkistaminen ajastimella kuluttaa tilin 40 kutsua minuutissa kyseiseen endpointiin riippumatta siitä, onko mitään muuttunut. TikTokin webhookit ovat olemassa korvaamaan sen: julkaisutapahtumat raportoivat julkaisun jokaisen vaiheen, ja comment.update ilmoittaa uudesta kommentista viiden minuutin sisällä. Sivuittain lukeminen, 20 julkaisua tai 30 kommenttia kutsua kohden, ja Mentions-datan hakeminen kerran päivässä pitävät muun vähäisenä.
Miten easyCoexistence käsittelee rajoitetun TikTok-kutsun?
Se välittää TikTokin vastauksen eteenpäin eikä piilota sitä. Työkalukutsu, jonka TikTok rajoittaa, kuten list_social_comments, reply_to_comment tai get_tiktok_publish_status, palautuu tekoälylle virheenä, joka nimeää koodin 40100 TikTokin viestin kanssa, eikä sitä toisteta itsestään. Julkaisut kulkevat eri reittiä, sillä publish_tiktok_post luovuttaa jokaisen easyCoexistencen jonoon, joko heti tai asetettuun aikaan:
- Jono odottaa ja yrittää uudelleen 5 minuutin, 30 minuutin ja 2 tunnin kuluttua, kun vastaus tulee HTTP 429:nä.
- TikTok lähettää 40100-koodin HTTP 200 -vastauksen sisällä, joten rajoitettu TikTok-julkaisu epäonnistuu TikTokin viestillä ja odottaa kohdassa ”Needs attention” Retry-painiketta.
- 40100 jonon tilatarkistuksessa merkitsee julkaisunkin epäonnistuneeksi, vaikka TikTok on ehkä jo julkaissut sen: tarkista tilin uusimmat julkaisut ennen Retryä.
- Taustalla epäonnistunut julkaisu lähettää omistajalle sähköpostin, enintään kerran kanavaa kohden 3 tunnin välein.
Mitä TikTok-kutsuja easyCoexistence tekee tilille?
Muutamia, ja ne lasketaan tilin rajoihin samalla tavalla kuin omat kutsusi:
- /business/get/ noin 6 tunnin välein tarkistaakseen, että tili yhä vastaa.
- Yksi julkaisukutsu jokaista julkaisua kohden, sitten /business/publish/status/ noin 20 sekunnin välein, kunnes TikTok saa julkaisun valmiiksi tai se epäonnistuu, enintään 2 tuntia.
- Kun kommenttisäännöt tai automaatiot ovat päällä, yksi /business/comment/list/-kutsu jokaista uutta ylimmän tason kommenttia kohden kirjoittajan lukemiseksi, ja yksi kutsu jokaiselle lähetetylle vastaukselle.
- Työkalukutsut vain kun tekoäly tai koodisi pyytää, 20 julkaisua tai 30 kommenttia lukua kohden.
Yleiset virheet
- Rajoituksen tunnistaminen HTTP-tilasta. TikTok vastaa 40100:lla HTTP 200:lla, joten tarkistus res.ok:iin tai 429:ään ohittaa sen; lue koodi rungosta.
- Sovelluksen tason nostaminen yhden kiireisen tilin takia. 40 kutsua minuutissa tiliä ja endpointia kohden pysyy samana kaikilla neljällä tasolla, joten levitä tilin kutsut ajalle.
- Mentions-datan hakeminen useita kertoja päivässä. TikTok päivittää sen kerran, keskiyön ja klo 7 UTC välillä, ja suosittelee yhtä kutsua endpointia ja tiliä kohden päivässä.
US$ 9 yhdestä yhteydestä kuukaudessa alkaen, laskien US$ 0,75:een yhteyksien lisääntyessä, ensimmäiset 3 päivää ovat ilmaisia.
Usein kysytyt kysymykset
Mikä on TikTok API:n nopeusrajoitus tiliä kohden?
40 kyselyä minuutissa jokaiselle Accounts API:n endpointille ja jokaiselle valtuutetulle TikTok-tilille, sovelluksen yhteisen budjetin 600 minuutissa Basic-tasolla tai 1 000 sen yläpuolella sisällä.
Lasketaanko TikTokin nopeusrajat endpointeittain?
Kyllä. TikTokin oppaan mukaan endpointikohtaiset rajat ovat toisistaan riippumattomia, joten yhden endpointin rajan saavuttaminen ei pysäytä kutsuja toiseen.
Miten nostan TikTok API:n nopeusrajaani?
Pyydä korotusta kohdassa My Apps, App Detail, Authorization ja anna perustelu. Tasot nousevat yksi askel kerrallaan, Basicista Advancediin, sitten Premiumiin ja lopuksi Ultimateen.
Lasketaanko easyCoexistencen kutsut TikTokin rajoihin?
Kyllä. Ne ajetaan yhdistetyn tilin nimissä sen tokenilla, joten ne lasketaan sen 40 kutsuun minuutissa endpointia kohden kuten mikä tahansa muu kutsu tilille.
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