API හරහා TikTok වෙත වීඩියෝවක් publish කරන ආකාරය
TikTok හි API for Business හරහා වීඩියෝවක් පළ කිරීමට, ගිණුමේ business_id, සත්යාපනය කළ domain එකක හෝ URL prefix එකක video_url සහ caption හා සැකසුම් ඇති post_info object එක සමඟ POST /business/video/publish/ යවන්න, Access-Token header එක සමඟ. TikTok share_id එකක් ලබා දෙයි; status එක PUBLISH_COMPLETE ලෙස පෙන්වන තෙක් සහ post_ids දිස්වන තෙක්, එය publish_id ලෙස /business/publish/status/ වෙත යවන්න.
easyCoexistence Claude, ChatGPT හෝ ඔබේම agent එකෙන් publish_tiktok_post සමඟ TikTok වීඩියෝ post කරයි: HTTPS link එක, caption සහ comments සක්රිය දැයි දී, ඉන් පසු get_tiktok_publish_status සමඟ post එක අනුගමනය කරන්න; ගොනුව එහි සත්යාපනය කළ media route හරහා TikTok වෙත ළඟා වේ.
publish call එකෙන් ලැබෙන, උදාහරණයක් ලෙස v_pub_url~v1.2345123456789123456 වැනි, status call එකට publish_id ලෙස යවනු ලබයි.
ඉන් පසු, domain එක හෝ URL prefix එක සත්යාපනය කර නොමැති URL වලින් වීඩියෝ publish කිරීම TikTok ප්රතික්ෂේප කරයි.
publish endpoint එක හරහා එක් ගිණුමකට TikTok පළ කළ හැකි වීඩියෝ post සීමාව, දිනකට උපරිම 15කි.
PUBLISH_COMPLETE පසු post_ids දිස්වීමට ගත හැකි කාලය; TikTok විනාඩි තුනකට පසු නැවත උත්සාහ කරන ලෙස කියයි.
post එක moderation පරීක්ෂාව පසු කළ පසු post.publish.publicly_available webhook එකෙන් යවනු ලබයි; insights විමසීමට සූදානම්ව.
පළමු call එකට පෙර ඔබට අවශ්ය දේ මොනවාද?
තුනක් අවශ්යයි. token exchange එකෙන් ලබාගත් ගිණුමේ access token එක සහ ගිණුමේ open_id; TikTok Accounts යටතේ Video Publish අවසරය ඇති developer යෙදුමක්; සහ යෙදුමට සත්යාපනය කළ domain එකක් හෝ URL prefix එකක් යටතේ පවතින, පොදු HTTPS හෝ HTTP URL එකක වීඩියෝව. TikTok ගොනුව තමාම බාගන්නා බැවින්, එය ප්රවේශ්ය ව පැවතිය යුතුය; අවම වශයෙන් විනාඩි 30ක් කාලය පවතින URL එකක් TikTok නිර්දේශ කරයි.
publish request එක කෙසේ පෙනේද?
https://business-api.tiktok.com/open_api/v1.3/business/video/publish/ වෙත POST එකක්, ගිණුමේ token එක Access-Token header එකෙහි සහ Content-Type application/json ලෙස සකසා. JSON body එක business_id හි ගිණුම, video_url හි ගොනුව සහ post_info හි post එකේ සැකසුම් නම් කරයි; මෙය comments, Duet සහ Stitch ක්රියාත්මකව තබා, caption සහිත වීඩියෝවක් publish කරයි:
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
}
}'body field එකක් එකිනෙක කුමක් කරයිද?
TikTok හි reference හි වීඩියෝ post සඳහා ලැයිස්තු කරන field, ඉහළ මට්ටමෙන් ආරම්භ කරමින්. cover, AI-generated label, ස්ථානය, drafts සහ ads-only විකල්පය එම body එකේම ඇත:
business_id: token exchange එකෙන් ලැබෙන ගිණුමේopen_id.video_url: TikTok බාගන්නා ගොනුව, MP4, MOV හෝ WebM, සත්යාපනය කළ domain එකක හෝ URL prefix එකක.post_info: සෑම call එකකම අවශ්යයි, හිස් object එකක් ලෙස වුවද; post එකේ සැකසුම් ඇති ස්ථානයයි.post_info.caption: UTF-16 ලෙස ගණන් කළ අක්ෂර 2,200 දක්වා, #hashtags සහ @mentions 30 දක්වා.post_info.is_brand_organicසහis_branded_content: TikTok වගුව අවශ්ය ලෙස සලකුණු කරන Promotional content සහ Paid partnership ලේබල.post_info.disable_comment,disable_duetසහdisable_stitch: true ලෙස සැකසූ විට comments, Duet හෝ Stitch අක්රිය වේ; තුනම පෙරනිමියෙන් false වේ.
TikTok ආපසු ලබා දෙන්නේ කුමක්ද?
සාමාන්ය envelope එක, data තුළ publishing task එකේ ID එක සමඟ. කේතය 0 යනු TikTok task එක පිළිගත් බවයි, වීඩියෝව සජීවී බව නොවේ: TikTok තවමත් ගොනුව බාගත යුතුය, පරීක්ෂා කළ යුතුය සහ post එක moderation කළ යුතුය. TikTok උදාහරණ වලදී, වීඩියෝවක share_id එක v_pub_url වලින් ද, photo post එකක එක p_pub_url වලින් ද ආරම්භ වේ.
{
"code": 0,
"message": "Ok",
"request_id": "20210817034316010245031056097316BA",
"data": {
"share_id": "v_pub_url~v1.2345123456789123456"
}
}post එක සජීවී වන තුරු එය අනුගමනය කරන්නේ කෙසේද?
GET /business/publish/status/ සමඟ, business_id සහ share_id publish_id ලෙස යවමින්. TikTok ගොනුව ලබාගන්නා අතරතුර status එක PROCESSING_DOWNLOAD ලෙස කියවෙයි, post එක moderation පසු කළ පසු PUBLISH_COMPLETE, හෝ හේතුවක් සමඟ FAILED. post එක පොදුවේ බැලිය හැකි වූ විට PUBLISH_COMPLETE සමඟ post_ids පැමිණෙන අතර, එය විනාඩි තුනක් දක්වා ප්රමාද විය හැක. සම්පූර්ණ ප්රවාහය 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"])
breakwebhook එකකට status පරීක්ෂා කිරීම් ප්රතිස්ථාපනය කළ හැකිද?
ඔව්, event_type VIDEO සඳහා /business/webhook/update/ සමඟ දායකත්වය ලබන යෙදුමකට. ගොනුව බාගත කර පරීක්ෂා කළ පසු TikTok post.publish.failed හෝ post.publish.complete යවයි, moderation පසු කළ පසු නව post_id සමඟ post.publish.publicly_available යවයි, පසුව post එක පොදු දසුනෙන් ඉවත් වුවහොත් post.publish.no_longer_publicly_available යවයි. සෑම event එකක්ම task එක publish_id තුළ නම් කරයි, එය share_id ට සමාන අගයයි.
MCP හරහා වීඩියෝවක් post කරන්නේ කෙසේද?
https://easycoexistence.com/api/mcp වෙත සම්බන්ධ Claude, ChatGPT හෝ වෙනත් client එකෙන් සරල වචනවලින් එය ඉල්ලන්න. assistant එක list_social_accounts වෙතින් account_id, HTTPS video_url, caption සහ comments අක්රිය කිරීමට ඔබ කැමති නම් disable_comment සමඟ publish_tiktok_post call කරයි. ප්රතිඵලයේ TikTok හි share_id ඇත; account_id සහ එම share_id ලබා දුන් විට, get_tiktok_publish_status මගින් TikTok හි status, post_ids සහ reason ඒ ආකාරයෙන්ම ආපසු ලබා දෙයි.
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>"] }publish_tiktok_post TikTok වෙත කුමක් යවයිද?
එම endpoint එකට call එකක්, ඔබේ ඉල්ලීමෙන් පිරවූ. ඔබේ link එක easyCoexistence හි තමාගේම සත්යාපනය කළ media route එක යටතේ අත්සන් කළ link එකක් ලෙස TikTok වෙත යයි, එබැවින් එයට තමාගේම සත්යාපනයක් අවශ්ය නොවේ; caption සහ disable_comment ඔබ දුන් ආකාරයටම යයි; සහ is_brand_organic සහ is_branded_content false ලෙස යයි. අනෙකුත් සැකසුම්, උදාහරණ ලෙස Duet, Stitch, cover සහ AI-generated label, TikTok හි පෙරනිමි තබා ගනී, සහ endpoint එක ගොඩනගා ඇති ආකාරයට වීඩියෝව public post එකක් ලෙස publish කරයි.
Partner API එකෙන් ලැබෙන credentials සමඟ ඔබට කුමක් කළ හැකිද?
ගිණුම ලෙස TikTok වෙතට සෘජුවම call කළ හැක. https://easycoexistence.com/api/v1 මත GET /channels/{id}?credentials=1, bearer token ලෙස ඔබේ ec_live_ key එක සමඟ, credentials object එකක් සහිත channel එක ආපසු ලබා දෙයි: api_base, business_id, වත්මන් access_token සහ token_expires_at. ඉන් පසු status පරීක්ෂා, වීඩියෝ ලැයිස්තු, comments සහ insights ඔබේම කේතයෙන් ධාවනය වේ. සැලසුම් කළ යුත්තේ publishing ය: සෘජු publish call එකක් video_url TikTok වෙත වෙනස් නොකර යවයි, URL ගුණාංග එකතු කරන්නේ developer යෙදුමේම ID සහ secret සමඟ, සහ easyCoexistence හි යෙදුම සත්යාපනය කළ prefix එක එහි media route එකයි, එය publish_tiktok_post භාවිතා කරයි.
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>'එය සකසන ආකාරය
- 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.
- 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.
- 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/.
- Keep the share_idStore data.share_id from the response, the ID of this publishing task.
- Check the statusEvery few minutes, GET /business/publish/status/ with business_id and the share_id as publish_id, until PUBLISH_COMPLETE or FAILED.
- 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.
සාමාන්ය වැරදි
- post_info අමතක කිරීම. TikTok සෑම call එකකම object එක අවශ්ය කරයි, කිසිම සැකසුමක් වෙනස් නොවුවද.
- publish response එකේ post ID එකක් සොයන්න. එය share_id පමණක් ලබා දෙයි; post IDs පැමිණෙන්නේ status call එකෙන් හෝ publicly_available webhook එකෙන්.
- කාලය ඉක්මවූ publish call එකක් නැවත යැවීම. පළමු ඉල්ලීම TikTok වෙත ළඟා වී තිබිය හැකි බැවින්, නැවත යැවීමට පෙර ගිණුමේ අන්තිම post එක පරීක්ෂා කරන්න.
- කේතය 0 සජීවී වීඩියෝවක් ලෙස සැලකීම. එයින් අදහස් වන්නේ TikTok task එක පිළිගත් බවයි, බාගැනීමෙන් පසුවත් ගොනුව පරීක්ෂාවන්හි අසමත් විය හැක.
සම්බන්ධතාවයක් සඳහා මාසයකට US$ 9 සිට US$ 0.75 දක්වා, සම්බන්ධතා එකතු කරන විට අඩු වේ, පළමු දින 3 නොමිලේ trial කාලය.
නිතර අසන ප්රශ්න
කුමන endpoint එකකින් TikTok වෙත වීඩියෝවක් post කරයිද?
POST https://business-api.tiktok.com/open_api/v1.3/business/video/publish/, ගිණුමේ token එක Access-Token header එකෙහි සහ business_id, video_url සහ post_info JSON body එකෙහි.
TikTok API එකට වීඩියෝ ගොනුවක් සෘජුවම upload කළ හැකිද?
/business/video/publish/ හරහා නොවේ. එය video_url ගන්නා අතර ගොනුව එහි සිට ලබාගනී, එබැවින් වීඩියෝවට සත්යාපනය කළ domain එකක හෝ URL prefix එකක URL එකක් තිබිය යුතුය.
API හරහා publish කළ වීඩියෝවක ID එක ලබාගන්නේ කෙසේද?
status PUBLISH_COMPLETE වී post එක පොදු වූ පසු /business/publish/status/ හි post_ids වලින්, හෝ post.publish.publicly_available webhook එකේ post_id වලින්.
API හරහා TikTok වීඩියෝවක් පසුවට කාලසටහන් කළ හැකිද?
publish endpoint එක call කරන විට post කරයි, වෙලාවක් සඳහා field එකක් නැත. easyCoexistence කාලසටහන් කළ post තමාගේම queue එකේ තබා, ඔබ සකසන වෙලාවට TikTok call කරයි.
තවදුරටත් කියවන්න
ඔබේ පළමු channel එක මිනිත්තු දෙකකින් සම්බන්ධ කරන්න.
වේදිකා සමාලෝචන සඳහා බලා සිටීමට අවශ්ය නැත. WhatsApp, Instagram, TikTok හෝ වෙනත් channel එකක් සම්බන්ධ කර, පසුව ඔබේ AI හට පළ කිරීමට, ප්රතිචාර දැක්වීමට හෝ වාර්තා කිරීමට පවසා එය වැඩ කරන ආකාරය බලන්න.
- දින 3ක් නොමිලේ
- ඕනෑම වේලාවක අවලංගු කරන්න
- නිල API පමණි
- 24/7 නිරීක්ෂණය කෙරේ
සත්යාපනය කළේ