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

Kuinka julkaista video TikTokiin API:n kautta

Videon julkaisu TikTokin API for Business -rajapinnan kautta tapahtuu lähettämällä POST /business/video/publish/ -pyynnön, jossa ovat tilin business_id, vahvistetulla domainilla tai URL-etuliitteellä oleva video_url sekä kuvatekstin ja asetukset sisältävä post_info-objekti, ja Access-Token-otsakkeella. TikTok vastaa share_id:llä; välitä se publish_id-kenttänä kohteeseen /business/publish/status/, kunnes tila on PUBLISH_COMPLETE ja post_ids ilmestyvät.

easyCoexistence julkaisee TikTok-videoita publish_tiktok_post-työkalulla Claudesta, ChatGPT:sta tai omasta agentista: anna HTTPS-linkki, kuvateksti ja se, ovatko kommentit päällä, ja seuraa julkaisua get_tiktok_publish_status-työkalulla, kun tiedosto siirtyy TikTokille vahvistetun mediareitin kautta.

share_id

Julkaisukutsu palauttaa tunnisteen, esimerkiksi v_pub_url~v1.2345123456789123456, ja se välitetään tilakutsuun publish_id-kenttänä.

Nov 16, 2023

Tästä lähtien TikTok kieltäytyy julkaisemasta videoita URL-osoitteista, joiden domainia tai URL-etuliitettä ei ole vahvistettu.

6 a minute

TikTokin raja tilikohtaisille videojulkaisuille julkaisu-endpointin kautta: enintään 15 päivässä.

3 min

Aika, joka post_ids voi kestää ilmestyä PUBLISH_COMPLETE-tilan jälkeen; TikTok suosittelee uutta yritystä kolmen minuutin kuluttua.

post_id

Lähetetään post.publish.publicly_available-webhookissa, kun julkaisu läpäisee moderoinnin, jolloin sen tilastoja voi kysellä.

Mitä tarvitset ennen ensimmäistä kutsua?

Kolme asiaa. TikTok-tilin access token ja tilin open_id, jotka saadaan tokenin vaihdosta; kehittäjäsovellus, jolla on Video Publish -oikeus kohdassa TikTok Accounts; ja video julkisessa HTTPS- tai HTTP-URL-osoitteessa, joka sijaitsee sovellukselle vahvistetun domainin tai URL-etuliitteen alla. TikTok lataa tiedoston itse, joten sen on pysyttävä tavoitettavissa, ja TikTok suosittelee URL-osoitetta, joka on voimassa vähintään 30 minuuttia.

Miltä julkaisupyyntö näyttää?

POST-pyyntö osoitteeseen https://business-api.tiktok.com/open_api/v1.3/business/video/publish/, jossa tilin token on Access-Token-otsakkeessa ja Content-Type on asetettu arvoon application/json. JSON-runko nimeää tilin business_id-kentässä, tiedoston video_url-kentässä ja julkaisun asetukset post_info-kentässä. Tämä esimerkki julkaisee videon kuvatekstin kanssa ja jättää kommentit, Duetin ja Stitchin päälle:

Publish a video with curl
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/launch.mp4",
    "post_info": {
      "caption": "Our new menu is live #food",
      "is_brand_organic": false,
      "is_branded_content": false,
      "disable_comment": false,
      "disable_duet": false,
      "disable_stitch": false
    }
  }'

Mitä kukin rungon kenttä tekee?

Kentät, jotka TikTokin viite listaa videojulkaisulle, ylimmästä tasosta alkaen. Kansi, tekoälyllä luotu merkintä, sijainti, luonnokset ja vain mainoksiin -valinta kuuluvat samaan runkoon:

  • business_id: tilin open_id, joka saadaan tokenin vaihdosta.
  • video_url: tiedosto, jonka TikTok lataa, MP4, MOV tai WebM, vahvistetulla domainilla tai URL-etuliitteellä.
  • post_info: vaaditaan jokaisessa kutsussa, vaikka tyhjänä objektina, ja siinä ovat julkaisun asetukset.
  • post_info.caption: enintään 2 200 merkkiä UTF-16-laskennalla, sisältäen #hashtagit ja enintään 30 @mainintaa.
  • post_info.is_brand_organic ja is_branded_content: merkinnät Promotional content ja Paid partnership, jotka TikTokin taulukko merkitsee pakollisiksi.
  • post_info.disable_comment, disable_duet ja disable_stitch: true kytkee kommentit, Duetin tai Stitchin pois; kaikki kolme ovat oletuksena false.

Mitä TikTok palauttaa?

Tavallinen vastausrakenne, jossa julkaisutehtävän tunniste on data-kentässä. Koodi 0 tarkoittaa, että TikTok hyväksyi tehtävän, ei sitä, että video on julkinen: TikTokin täytyy vielä ladata tiedosto, tarkistaa se ja moderoida julkaisu. TikTokin esimerkeissä videon share_id alkaa v_pub_url:lla ja kuvajulkaisun p_pub_url:lla.

The publish response
{
  "code": 0,
  "message": "Ok",
  "request_id": "20210817034316010245031056097316BA",
  "data": {
    "share_id": "v_pub_url~v1.2345123456789123456"
  }
}

Miten julkaisua seurataan, kunnes se on julkinen?

GET-pyynnöllä osoitteeseen /business/publish/status/, välittäen business_id ja share_id publish_id-kenttänä. status on PROCESSING_DOWNLOAD, kun TikTok hakee tiedostoa, PUBLISH_COMPLETE, kun julkaisu on läpäissyt moderoinnin, tai FAILED ja syy. post_ids ilmestyy PUBLISH_COMPLETE-tilan yhteydessä, kun julkaisu on julkisesti katsottavissa, ja se voi jäädä jälkeen enintään kolme minuuttia. Koko kulku Pythonissa:

Publish and follow a video in Python
import os, time, requests

API = "https://business-api.tiktok.com/open_api/v1.3"
HEADERS = {"Access-Token": os.environ["TIKTOK_ACCESS_TOKEN"]}
BUSINESS_ID = os.environ["TIKTOK_BUSINESS_ID"]  # open_id from the token exchange

def call(method, path, **kwargs):
    body = requests.request(method, f"{API}/{path}", headers=HEADERS, timeout=30, **kwargs).json()
    if body.get("code") != 0:  # errors arrive in code, usually with HTTP 200
        raise RuntimeError(f"{body.get('code')}: {body.get('message')}")
    return body["data"]

share_id = call("POST", "business/video/publish/", json={
    "business_id": BUSINESS_ID,
    "video_url": "https://media.example.com/tiktok/launch.mp4",
    "post_info": {"caption": "Our new menu is live #food",
                  "is_brand_organic": False, "is_branded_content": False},
})["share_id"]

for _ in range(30):
    time.sleep(60)  # each check is a call; TikTok's stages take minutes
    s = call("GET", "business/publish/status/",
             params={"business_id": BUSINESS_ID, "publish_id": share_id})
    if s["status"] == "FAILED":
        raise RuntimeError(s.get("reason"))
    if s["status"] == "PUBLISH_COMPLETE" and s.get("post_ids"):
        print("Live:", s["post_ids"])
        break

Voiko webhook korvata tilatarkistukset?

Kyllä, sovellukselle, joka tilaa tapahtumatyypin VIDEO kohteessa /business/webhook/update/. TikTok lähettää sitten tapahtuman post.publish.failed tai post.publish.complete, kun se on ladannut ja tarkistanut tiedoston, tapahtuman post.publish.publicly_available uuden post_id:n kanssa, kun moderointi läpäistään, ja tapahtuman post.publish.no_longer_publicly_available, jos julkaisu myöhemmin poistuu julkisesta näkymästä. Jokainen tapahtuma nimeää tehtävän publish_id-kentässä, joka on sama arvo kuin share_id.

Miten julkaistaan video MCP:n kautta?

Pyydä sitä tavallisin sanoin Claudelta, ChatGPT:lta tai muulta osoitteeseen https://easycoexistence.com/api/mcp yhdistetyltä asiakkaalta. Assistentti kutsuu publish_tiktok_post-työkalua list_social_accounts-kutsusta saadulla account_id:llä, HTTPS-muotoisella video_url-osoitteella, kuvatekstillä ja tarvittaessa disable_comment-asetuksella, jos haluat kommentit pois. Tulos sisältää TikTokin share_id:n, ja get_tiktok_publish_status palauttaa account_id:n ja share_id:n perusteella TikTokin tilan, post_ids:n ja syyn sellaisina kuin ne ovat.

The MCP tool calls and their results
publish_tiktok_post {
  "account_id": "<ACCOUNT_ID>",
  "video_url": "https://media.example.com/tiktok/launch.mp4",
  "caption": "Our new menu is live #food",
  "disable_comment": false
}
=> { "share_id": "v_pub_url~v1.2345123456789123456",
     "note": "TikTok is processing the post. Check it with get_tiktok_publish_status." }

get_tiktok_publish_status { "account_id": "<ACCOUNT_ID>", "share_id": "v_pub_url~v1.2345123456789123456" }
=> { "status": "PUBLISH_COMPLETE", "post_ids": ["<POST_ID>"] }

Mitä publish_tiktok_post lähettää TikTokille?

Kutsun samaan endpointiin, täytettynä pyynnöstäsi. Linkkisi menee TikTokille allekirjoitettuna linkkinä easyCoexistencen oman vahvistetun mediareitin alla, joten se ei vaadi omaa vahvistusta. Kuvateksti ja disable_comment menevät sellaisina kuin annoit ne, ja is_brand_organic ja is_branded_content menevät arvolla false. Muut asetukset, kuten Duet, Stitch, kansi ja tekoälyllä luotu merkintä, pitävät TikTokin oletukset, ja video julkaistaan julkisena postauksena, kuten endpoint on tarkoitettu tekemään.

Mitä voit tehdä Partner API:n tunnuksilla?

Kutsua TikTokia suoraan tilin nimissä. GET /channels/{id}?credentials=1 osoitteessa https://easycoexistence.com/api/v1, ec_live_-avaimesi bearer tokenina, palauttaa kanavan credentials-objektilla: api_base, business_id, ajantasainen access_token ja token_expires_at. Tilatarkistukset, videolistat, kommentit ja tilastot ajetaan sitten omasta koodistasi. Julkaisu on osa, joka pitää suunnitella: suora julkaisukutsu välittää video_url-osoitteen TikTokille sellaisenaan, URL-ominaisuudet lisätään kehittäjäsovelluksen oman ID:n ja salaisuuden kanssa, ja easyCoexistencen sovelluksen vahvistama etuliite on sen mediareitti, jota publish_tiktok_post käyttää.

Credentials from the Partner API, then a direct status check
curl "https://easycoexistence.com/api/v1/channels/$CHANNEL_ID?credentials=1" \
  -H "Authorization: Bearer $EC_API_KEY"

# "credentials": {
#   "platform": "tiktok",
#   "api_base": "https://business-api.tiktok.com/open_api/v1.3",
#   "business_id": "<OPEN_ID>",
#   "access_token": "<ACCESS_TOKEN>",
#   "token_expires_at": "2026-11-01T09:00:00.000Z", ...
# }

curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/publish/status/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  --data-urlencode 'business_id=<OPEN_ID>' \
  --data-urlencode 'publish_id=<SHARE_ID>'

Näin otat sen käyttöön

  1. Get the token and the account IDExchange the owner's authorization code at /tt_user/oauth2/token/, and keep access_token for the header and open_id for business_id.
  2. Host the videoPut the MP4, MOV or WebM file under a domain or URL prefix verified for your app, where it stays reachable for at least 30 minutes.
  3. Call the publish endpointPOST business_id, video_url and post_info, with the caption, the two brand flags and the engagement switches, to /business/video/publish/.
  4. Keep the share_idStore data.share_id from the response, the ID of this publishing task.
  5. Check the statusEvery few minutes, GET /business/publish/status/ with business_id and the share_id as publish_id, until PUBLISH_COMPLETE or FAILED.
  6. Record the post IDTake it from post_ids, or from post_id in the post.publish.publicly_available webhook, to read the video's metrics later.

Yleiset virheet

  • post_info:n jättäminen pois. TikTok vaatii objektin jokaisessa kutsussa, vaikka mikään asetus ei muutu.
  • Julkaisuvastauksesta etsiminen julkaisun ID:tä. Se palauttaa vain share_id:n, ja post_id:t tulevat tilakutsusta tai publicly_available-webhookista.
  • Aikakatkaistun julkaisukutsun toistaminen. Ensimmäinen pyyntö on voinut saavuttaa TikTokin, joten tarkista tilin uusimmat julkaisut ennen kuin lähetät sen uudelleen.
  • Koodin 0 pitäminen elävänä videona. Se tarkoittaa, että TikTok hyväksyi tehtävän, ja tiedosto voi silti epäonnistua tarkistuksissa latauksen jälkeen.
Näin teet tämän EasyCoexistencen avulla

US$ 9–US$ 0,75 per yhteys kuukaudessa, halvemmaksi kun lisäät yhteyksiä, ensimmäiset 3 päivää ilmaiseksi.

Usein kysytyt kysymykset

Mikä endpoint julkaisee videon TikTokiin?

POST https://business-api.tiktok.com/open_api/v1.3/business/video/publish/, tilin tokenin ollessa Access-Token-otsakkeessa ja business_id, video_url sekä post_info JSON-rungossa.

Voiko TikTok API ladata videotiedoston suoraan?

Ei /business/video/publish/-kutsulla. Se ottaa video_url-osoitteen ja hakee tiedoston sieltä, joten videon on oltava URL-osoitteessa vahvistetulla domainilla tai URL-etuliitteellä.

Miten saan API:n kautta julkaistun videon tunnuksen?

Kentästä post_ids /business/publish/status/-kutsussa, kun tila on PUBLISH_COMPLETE ja julkaisu on julkinen, tai post.publish.publicly_available-webhookin post_id-kentästä.

Voiko TikTok-videon ajastaa myöhempää julkaisua varten API:n kautta?

Julkaisu-endpoint julkaisee heti kun sitä kutsutaan eikä siinä ole aikakenttää. easyCoexistence pitää ajastetut julkaisut omassa jonossaan ja kutsuu TikTokia asettamallasi ajankohtana.

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