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

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.

video.upload

Oikeus, jonka TikTok määrittelee jakamaan sisältöä sisällöntuottajan tilille luonnoksena, jota voi muokata ja julkaista TikTokissa.

5 pending

Enimmäismäärä odottavia jakoja, jonka Content Posting API sallii mihin tahansa 24 tunnin jaksoon. TikTok asettaa rajan roskapostin vähentämiseksi.

SEND_TO_USER_INBOX

Tila /business/publish/status/ ilmoittaa, kun luonnos on lähetetty ja TikTok on ilmoittanut sisällöntuottajan inboxiin.

6 a minute

Pyynnöt, joita kukin käyttäjän access token voi lähettää Content Posting API:n upload-päätepisteeseen.

Ignored

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 postsThe creator, in the TikTok appThe app, through the API
Token scopevideo.upload, on both APIsvideo.publish on the Content Posting API
Content Posting API/v2/post/publish/inbox/video/init//v2/post/publish/video/init/
API for Businessupload_to_draft or is_draft set to trueThe same endpoints without them
Status once handed overSEND_TO_USER_INBOXPUBLISH_COMPLETE once live
Caption and settingsMostly finished by the creator in TikTokSent 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:

Upload a video to the creator's inbox from a URL
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_share ja HTTP 403.
  • Pyynnöt: 6 pyyntöä minuutissa käyttäjän access tokenia kohden. Sen jälkeen rate_limit_exceeded ja HTTP 429.
  • Oikeus: token ilman video.upload-oikeutta saa vastauksen scope_not_authorized ja HTTP 401.
  • Media: PULL_FROM_URL-haku domainista tai etuliitteestä, jota sovellus ei ole vahvistanut, saa vastauksen url_ownership_unverified ja 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:

Send a video to the creator's drafts on the API for Business
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.
Näin teet tämän EasyCoexistencen avulla

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