Videon lähettäminen TikTok-sisällöntuottajan luonnoksiin API:n kautta
TikTokin API:t lähettävät videon sisällöntuottajan luonnoksiin upload-kulun avulla: Content Posting API:n /v2/post/publish/inbox/video/init/ lähettää sen video.upload-oikeudella, ja TikTok ilmoittaa sisällöntuottajalle inboxissa, että hän voi muokata ja julkaista sen sovelluksessa. API for Business tekee saman upload_to_draft-kentällä päätepisteessä /business/video/publish/ tai is_draft-kentällä kuvapostauksissa.
easyCoexistence julkaisee TikTok-videoita ja kuvapostauksia publish_tiktok_post-työkalulla Claudesta, ChatGPT:stä tai omasta alustastasi, heti tai tiettynä päivänä ja kellonaikana enintään 90 päivää eteenpäin.
Oikeus, jonka TikTok määrittelee jakamaan sisältöä sisällöntuottajan tilille luonnoksena, jota voi muokata ja julkaista TikTokissa.
Enimmäismäärä odottavia jakoja, jonka Content Posting API sallii mihin tahansa 24 tunnin jaksoon. TikTok asettaa rajan roskapostin vähentämiseksi.
Tila /business/publish/status/ ilmoittaa, kun luonnos on lähetetty ja TikTok on ilmoittanut sisällöntuottajan inboxiin.
Pyynnöt, joita kukin käyttäjän access token voi lähettää Content Posting API:n upload-päätepisteeseen.
Mitä post_info-kentille tapahtuu, kun upload_to_draft on true päätepisteessä /business/video/publish/.
Miten luonnos eroaa suorasta julkaisusta?
Siinä, kuka julkaisee postauksen. Suora julkaisu menee näkyviin heti, kun TikTok on käsitellyt sen. Luonnos laskeutuu sisällöntuottajan TikTok-inboxiin, ja se julkaistaan vasta, kun tuottaja avaa sen, muokkaa haluamallaan tavalla ja julkaisee. Ero näkyy molemmissa TikTokin julkaisu-API:ssa:
| Draft (upload) | Direct post | |
|---|---|---|
| Who posts | The creator, in the TikTok app | The app, through the API |
| Token scope | video.upload, on both APIs | video.publish on the Content Posting API |
| Content Posting API | /v2/post/publish/inbox/video/init/ | /v2/post/publish/video/init/ |
| API for Business | upload_to_draft or is_draft set to true | The same endpoints without them |
| Status once handed over | SEND_TO_USER_INBOX | PUBLISH_COMPLETE once live |
| Caption and settings | Mostly finished by the creator in TikTok | Sent in the call |
Miten Content Posting API lähettää luonnoksen?
POST-pyynnöllä osoitteeseen https://open.tiktokapis.com/v2/post/publish/inbox/video/init/, käyttäjän access tokenilla, jolla on video.upload-oikeus, ja source_info-objektilla. PULL_FROM_URL pyytää TikTokia hakemaan videon sovelluksen vahvistamasta verkkotunnuksesta tai URL-etuliitteestä. FILE_UPLOAD palauttaa upload_url-osoitteen, johon tiedosto lähetetään osissa PUT-pyynnöillä. Palautettu publish_id menee päätepisteeseen /v2/post/publish/status/fetch/. Kuvat käyttävät päätepistettä /v2/post/publish/content/init/, jossa post_mode on MEDIA_UPLOAD. TikTok pyytää sovelluksia kehottamaan käyttäjiä avaamaan inbox-ilmoituksen, jotta he voivat jatkaa muokkaamista TikTokissa:
curl -X POST 'https://open.tiktokapis.com/v2/post/publish/inbox/video/init/' \
-H 'Authorization: Bearer <USER_ACCESS_TOKEN>' \
-H 'Content-Type: application/json; charset=UTF-8' \
-d '{
"source_info": {
"source": "PULL_FROM_URL",
"video_url": "https://media.example.com/tiktok/draft.mp4"
}
}'
# data.publish_id: pass it to /v2/post/publish/status/fetch/Mitkä rajat koskevat Content Posting API:n luonnoksia?
TikTok dokumentoi nämä latausohjeessaan. Jokainen palautetaan alustuskutsusta, kun se on voimassa:
- Odottavia luonnoksia: enintään 5 odottavaa jakoa 24 tunnin jaksossa. Sen jälkeen
spam_risk_too_many_pending_shareja HTTP 403. - Pyynnöt: 6 pyyntöä minuutissa käyttäjän access tokenia kohden. Sen jälkeen
rate_limit_exceededja HTTP 429. - Oikeus: token ilman video.upload-oikeutta saa vastauksen
scope_not_authorizedja HTTP 401. - Media:
PULL_FROM_URL-haku domainista tai etuliitteestä, jota sovellus ei ole vahvistanut, saa vastauksenurl_ownership_unverifiedja HTTP 403.
Miten API for Business lähettää luonnoksen?
Julkaisupäätepisteillään ja yhdellä lisäkentällä post_info-objektissa. Päätepisteessä /business/video/publish/ upload_to_draft-arvo true lähettää videon luonnoksena, ja TikTok jättää huomiotta muut post_info-kentät. Päätepisteessä /business/photo/publish/ is_draft säilyttää vain otsikon ja kuvatekstin. Molemmat vaativat video.upload-oikeuden tilin tokenilla, jonka /tt_user/token_info/get/ listaa. Ilman sitä omistaja hyväksyy luonnosten lähettämisen valtuuttamalla sovelluksen uudelleen. Media on edelleen vahvistetussa URL-osoitteessa, tila on SEND_TO_USER_INBOX, ja sisällöntuottaja löytää luonnoksen inbox-ilmoituksen kautta:
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/video/publish/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"business_id": "<OPEN_ID>",
"video_url": "https://media.example.com/tiktok/draft.mp4",
"post_info": {
"upload_to_draft": true,
"is_brand_organic": false,
"is_branded_content": false
}
}'Mitä sisällöntuottaja tekee luonnoksella?
Viimeistelee sen TikTokissa. Inbox-ilmoitus avaa ladatun videon tai kuvat TikTokin editorissa, jossa tuottaja tarkistaa ne, muokkaa ja julkaisee. Content Posting API:ssa tila siirtyy SEND_TO_USER_INBOX-tilasta PUBLISH_COMPLETE-tilaan, kun tuottaja julkaisee luonnoksesta. TikTok huomauttaa, että yhdestä luonnoksesta voi syntyä useampi kuin yksi julkaisu.
Lähettääkö easyCoexistence luonnoksia?
Ei: publish_tiktok_post julkaisee. Se kutsuu päätepistettä /business/video/publish/ tai /business/photo/publish/ ilman upload_to_draft- tai is_draft-kenttää, joten postaus menee näkyviin heti, kun TikTok on käsitellyt sen. Jos haluat pidättää postauksen tarkistettavaksi, ajasta se scheduled_at-kentällä, 1 minuutista 90 päivään eteenpäin. Se odottaa Posts-näkymässä kohdassa ”Coming up”. update_scheduled_post muuttaa sen aikaa, kuvatekstiä tai kuvapostauksen otsikkoa, ja cancel_scheduled_post pysäyttää sen ennen julkaisua.
Yleiset virheet
- Videon luonnoksen lähettämiseen pyydetään video.publish. Luonnokset tarvitsevat video.upload-oikeuden, jonka TikTok kuvaa sisällön jakamiseksi luonnoksena.
- Kuvatekstin asettaminen video-luonnokselle API for Business -rajapinnan kautta. Kun upload_to_draft on true, TikTok jättää muun post_info-osan huomiotta.
- Luonnosten lähettäminen nopeammin kuin tuottajat julkaisevat niitä. Content Posting API pysähtyy 5 odottavaan jakoon 24 tunnissa ja palauttaa spam_risk_too_many_pending_share-virheen.
- Käyttäjälle ei kerrota, mistä luonnos löytyy. TikTok pyytää sovelluksia kehottamaan heitä avaamaan inbox-ilmoituksen postauksen viimeistelemiseksi.
Jokainen jonossa oleva postaus näkyy Posts-näkymässä, kunnes se menee ulos. Hinta on US$ 9:stä US$ 0,75:een yhteyttä kohden kuukaudessa, ja se laskee, kun lisäät yhteyksiä. Ensimmäiset 3 päivää ovat ilmaisia.
Usein kysytyt kysymykset
Voiko TikTok API tallentaa videon luonnoksena?
Kyllä. Lähetysprosessi asettaa videon sisällöntuottajan TikTok-inboxiin, jossa tuottaja muokkaa ja julkaisee sen. Tokenilla täytyy olla video.upload-oikeus.
Mihin API:n kautta lähetetty luonnos ilmestyy?
TikTok-sovellukseen inbox-ilmoituksen taakse. Ilmoitus avaa videon TikTokin editorissa, jossa tuottaja viimeistelee sen.
Voiko TikTok-luonnos säilyttää kuvatekstini?
API for Business -rajapinnassa kuvaluonnos säilyttää otsikkonsa ja kuvatekstinsä, kun taas videoluonnos pudottaa muut post_info-kentät.
Voiko yhdestä TikTok-luonnoksesta tulla useampi postaus?
Kyllä. TikTok huomauttaa, että yhdestä luonnoksesta voi syntyä useampi postaus. Content Posting API:ssa tila siirtyy PUBLISH_COMPLETE-tilaan, kun tuottaja julkaisee siitä.
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