API வழியாக TikTok-க்கு வீடியோ பதிவிடுவது எப்படி
TikTok-இன் API for Business வழியாக வீடியோ வெளியிட, கணக்கின் business_id, சரிபார்க்கப்பட்ட டொமைன் அல்லது URL ப்ரிஃபிக்ஸில் உள்ள video_url, கேப்ஷன் மற்றும் அமைப்புகளைக் கொண்ட post_info பொருள் ஆகியவற்றுடன், Access-Token ஹெடரோடு POST /business/video/publish/ அனுப்புங்கள். TikTok ஒரு share_id தரும்; ஸ்டேட்டஸ் PUBLISH_COMPLETE ஆகி post_ids தோன்றும் வரை அதை /business/publish/status/-க்கு publish_id ஆக அனுப்புங்கள்.
easyCoexistence, Claude, ChatGPT அல்லது உங்கள் சொந்த ஏஜென்ட்டிலிருந்து publish_tiktok_post மூலம் TikTok வீடியோக்களைப் பதிவிடுகிறது: HTTPS இணைப்பு, கேப்ஷன், கருத்துகள் இயக்கத்தில் உள்ளதா என்பதைக் கொடுங்கள்; பிறகு get_tiktok_publish_status மூலம் பதிவைப் பின்தொடருங்கள்.
பப்ளிஷ் அழைப்பு திருப்பித் தருவது, எடுத்துக்காட்டாக v_pub_url~v1.2345123456789123456; இது status அழைப்புக்கு publish_id ஆக அனுப்பப்படுகிறது.
அப்போதிலிருந்து, சரிபார்க்கப்படாத டொமைன் அல்லது URL ப்ரிஃபிக்ஸ் கொண்ட URL-களிலிருந்து வீடியோக்களை TikTok வெளியிட மறுக்கிறது.
பப்ளிஷ் எண்ட்பாயிண்ட் வழியாக ஒரு கணக்குக்கு TikTok விதிக்கும் வீடியோ பதிவு வரம்பு, ஒரு நாளைக்கு அதிகபட்சம் 15.
PUBLISH_COMPLETE-க்குப் பிறகு post_ids தோன்ற எடுக்கக்கூடிய நேரம்; மூன்று நிமிடங்களுக்குப் பிறகு மீண்டும் முயலுமாறு TikTok கூறுகிறது.
ஒரு பதிவு மதிப்பாய்வில் தேறியதும் post.publish.publicly_available வெப்ஹூக்கில் அனுப்பப்படும்; அதன் insights-ஐ வினவத் தயாராக இருக்கும்.
முதல் அழைப்புக்கு முன் என்ன தேவை?
மூன்று விஷயங்கள் தேவை. டோக்கன் பரிமாற்றத்திலிருந்து கிடைக்கும் TikTok கணக்கின் அக்சஸ் டோக்கன் மற்றும் கணக்கின் open_id; TikTok Accounts-இன் கீழ் Video Publish அனுமதி கொண்ட டெவலப்பர் ஆப்; ஆப்புக்காகச் சரிபார்க்கப்பட்ட டொமைன் அல்லது URL ப்ரிஃபிக்ஸின் கீழ் உள்ள பொது HTTPS அல்லது HTTP URL-இல் வீடியோ. TikTok கோப்பைத் தானே பதிவிறக்கும் என்பதால் அந்த URL தொடர்ந்து அணுகக்கூடியதாக இருக்க வேண்டும்; குறைந்தது 30 நிமிடங்களுக்குச் செயல்படும் URL-ஐ TikTok பரிந்துரைக்கிறது.
பப்ளிஷ் கோரிக்கை எப்படி இருக்கும்?
Access-Token ஹெடரில் கணக்கின் டோக்கனுடனும், Content-Type application/json ஆகவும் https://business-api.tiktok.com/open_api/v1.3/business/video/publish/ என்ற முகவரிக்கு POST அனுப்பப்படும். JSON body-இல் business_id கணக்கைக் குறிப்பிடும், video_url கோப்பைக் குறிப்பிடும், பதிவின் அமைப்புகள் post_info-இல் இருக்கும். இந்த எடுத்துக்காட்டு கேப்ஷனுடன் கூடிய வீடியோவை வெளியிடுகிறது; கருத்துகள், Duet, Stitch ஆகியவை இயக்கத்திலேயே இருக்கும்:
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 புலமும் என்ன செய்கிறது?
TikTok-இன் குறிப்பு வழிகாட்டி வீடியோ பதிவுக்குப் பட்டியலிடும் புலங்கள், மேல் நிலையிலிருந்து தொடங்கி. கவர், AI-ஆல் உருவாக்கப்பட்ட லேபிள், இடம், டிராஃப்ட்கள், விளம்பரங்களுக்கு மட்டும் என்ற விருப்பம் ஆகியவையும் அதே body-இல் அமையும்:
business_id: டோக்கன் பரிமாற்றத்திலிருந்து கிடைக்கும் கணக்கின்open_id.video_url: TikTok பதிவிறக்கும் கோப்பு, MP4, MOV அல்லது WebM; சரிபார்க்கப்பட்ட டொமைன் அல்லது URL ப்ரிஃபிக்ஸில் இருக்க வேண்டும்.post_info: ஒவ்வொரு அழைப்பிலும் கட்டாயம், வெற்றுப் பொருளாகவாவது; பதிவின் அமைப்புகள் இதில் இருக்கும்.post_info.caption: UTF-16 கணக்கில் 2,200 எழுத்துகள் வரை; #ஹேஷ்டேக்குகளுடன், 30 @mention வரை.post_info.is_brand_organicமற்றும்is_branded_content: Promotional content, Paid partnership லேபிள்கள்; TikTok-இன் அட்டவணை இவற்றைக் கட்டாயம் என்று குறிக்கிறது.post_info.disable_comment,disable_duet,disable_stitch: true ஆக்கினால் கருத்துகள், Duet அல்லது Stitch அணைக்கப்படும்; மூன்றும் இயல்பாக false.
TikTok என்ன திருப்பித் தருகிறது?
வழக்கமான பதில் அமைப்பு (envelope), பதிவேற்ற பணியின் ID data-இல் இருக்கும். code 0 என்றால் TikTok பணியை ஏற்றுக்கொண்டது என்று பொருள்; வீடியோ நேரலையில் உள்ளது என்று பொருள் அல்ல. TikTok கோப்பைப் பதிவிறக்கி, சரிபார்த்து, பதிவை மதிப்பாய்வு செய்ய வேண்டும். TikTok-இன் எடுத்துக்காட்டுகளில், வீடியோவின் share_id v_pub_url என்றும், புகைப்படப் பதிவின் share_id p_pub_url என்றும் தொடங்கும்.
{
"code": 0,
"message": "Ok",
"request_id": "20210817034316010245031056097316BA",
"data": {
"share_id": "v_pub_url~v1.2345123456789123456"
}
}பதிவு நேரலைக்கு வரும் வரை எப்படிப் பின்தொடர்வது?
GET /business/publish/status/ மூலம், business_id மற்றும் share_id-ஐ publish_id ஆக அனுப்பி. TikTok கோப்பைப் பெறும்போது ஸ்டேட்டஸ் PROCESSING_DOWNLOAD என்று காட்டும்; பதிவு மதிப்பாய்வில் தேறியதும் PUBLISH_COMPLETE, தோல்வியுற்றால் காரணத்துடன் FAILED. பதிவு பொதுவில் பார்க்கக்கூடியதாக ஆனதும் 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"])
breakவெப்ஹூக் ஸ்டேட்டஸ் சோதனைகளை மாற்ற முடியுமா?
முடியும், event_type VIDEO-க்கு /business/webhook/update/ மூலம் சந்தா செய்யும் ஆப்புக்கு. TikTok கோப்பைப் பதிவிறக்கி சரிபார்த்ததும் post.publish.failed அல்லது post.publish.complete அனுப்பும்; மதிப்பாய்வு தேறியதும் புதிய post_id உடன் post.publish.publicly_available; பதிவு பின்னர் பொதுப் பார்வையை விட்டு வெளியேறினால் post.publish.no_longer_publicly_available. ஒவ்வொரு நிகழ்வும் publish_id-இல் பணியைக் குறிக்கும்; அதன் மதிப்பு share_id-க்குச் சமம்.
MCP வழியாக வீடியோவை எப்படிப் பதிவிடுவது?
https://easycoexistence.com/api/mcp இணைப்பில் உள்ள Claude, ChatGPT அல்லது வேறு கிளையன்ட்டிடம் எளிய சொற்களில் கேளுங்கள். list_social_accounts-இலிருந்து account_id, HTTPS video_url, கேப்ஷன், வேண்டுமெனில் disable_comment ஆகியவற்றுடன் உதவியாளர் publish_tiktok_post-ஐ அழைக்கும். விளைவில் TikTok-இன் share_id இருக்கும்; account_id மற்றும் அந்த share_id-ஐக் கொடுத்தால் get_tiktok_publish_status, TikTok-இன் ஸ்டேட்டஸ், post_ids, காரணம் ஆகியவற்றை அப்போதைய நிலையிலேயே திருப்பித் தரும்.
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-க்கு என்ன அனுப்புகிறது?
உங்கள் கோரிக்கையிலிருந்து நிரப்பப்பட்ட அதே எண்ட்பாயிண்டுக்கான அழைப்பு. உங்கள் இணைப்பு easyCoexistence-இன் சொந்த சரிபார்க்கப்பட்ட மீடியா பாதையின் கீழ் கையொப்பமிடப்பட்ட இணைப்பாக TikTok-க்குச் செல்லும்; அதற்குத் தனிச் சரிபார்ப்பு தேவையில்லை. கேப்ஷனும் disable_comment-உம் நீங்கள் கொடுத்தபடியே செல்லும்; is_brand_organic மற்றும் is_branded_content false ஆகச் செல்லும். Duet, Stitch, கவர், AI-உருவாக்கிய லேபிள் போன்ற மற்ற அமைப்புகள் TikTok-இன் இயல்பு மதிப்புகளிலேயே இருக்கும்; எண்ட்பாயிண்ட் கட்டமைக்கப்பட்டபடியே வீடியோ பொதுப் பதிவாக வெளியிடப்படும்.
Partner API-இன் நற்சான்றுகளுடன் என்ன செய்யலாம்?
கணக்கின் சார்பில் TikTok-ஐ நேரடியாக அழைக்கலாம். https://easycoexistence.com/api/v1-இல் GET /channels/{id}?credentials=1, உங்கள் ec_live_ கீயை bearer டோக்கனாகக் கொண்டு, credentials பொருளுடன் சேனலைத் திருப்பித் தரும்: api_base, business_id, தற்போதைய access_token மற்றும் token_expires_at. ஸ்டேட்டஸ் சோதனைகள், வீடியோ பட்டியல்கள், கருத்துகள், insights ஆகியவற்றை உங்கள் சொந்தக் குறியீட்டிலிருந்தே இயக்கலாம். பப்ளிஷ் செய்வதுதான் திட்டமிட வேண்டிய பகுதி: நேரடி பப்ளிஷ் அழைப்பு video_url-ஐ மாற்றாமல் TikTok-க்கு அனுப்பும்; URL பண்புகள் ஒரு டெவலப்பர் ஆப்பின் சொந்த ID மற்றும் secret உடன் சேர்க்கப்படும்; easyCoexistence-இன் ஆப் சரிபார்த்த ப்ரிஃபிக்ஸ் அதன் மீடியா பாதை, 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 அந்தப் பொருளைக் கட்டாயமாகக் கோருகிறது.
- பப்ளிஷ் பதிலில் post ID-ஐத் தேடுவது. அது share_id மட்டுமே திருப்பித் தரும்; post ID-கள் status அழைப்பிலிருந்து அல்லது publicly_available வெப்ஹூக்கிலிருந்து வரும்.
- நேரம் முடிந்த பப்ளிஷ் அழைப்பை மீண்டும் அனுப்புவது. முதல் கோரிக்கை TikTok-ஐ அடைந்திருக்கலாம்; மீண்டும் அனுப்பும் முன் கணக்கின் சமீபத்திய பதிவுகளைச் சரிபாருங்கள்.
- code 0 என்பதை நேரலை வீடியோ என்று கருதுவது. அதன் பொருள் TikTok பணியை ஏற்றுக்கொண்டது என்பதே; பதிவிறக்கத்துக்குப் பிறகும் கோப்பு சரிபார்ப்புகளில் தோல்வியடையலாம்.
கோப்பு அதன் சரிபார்க்கப்பட்ட மீடியா பாதை வழியாக TikTok-ஐச் சென்றடையும். ஓர் இணைப்புக்கு மாதம் US$ 9 முதல் US$ 0.75 வரை; இணைப்புகளைச் சேர்க்கும்போது கட்டணம் குறையும்; முதல் 3 நாட்கள் இலவசம்.
அடிக்கடி கேட்கப்படும் கேள்விகள்
எந்த எண்ட்பாயிண்ட் TikTok-க்கு வீடியோவை அனுப்புகிறது?
POST https://business-api.tiktok.com/open_api/v1.3/business/video/publish/, Access-Token ஹெடரில் கணக்கின் டோக்கனுடன், JSON body-இல் business_id, video_url மற்றும் post_info உடன்.
TikTok API நேரடியாக வீடியோ கோப்பைப் பதிவேற்ற முடியுமா?
/business/video/publish/ வழியாக முடியாது. அது video_url-ஐ எடுத்து அங்கிருந்து கோப்பைப் பெறும்; எனவே வீடியோவுக்குச் சரிபார்க்கப்பட்ட டொமைன் அல்லது URL ப்ரிஃபிக்ஸில் ஒரு URL தேவை.
API வழியாகப் பதிவிட்ட வீடியோவின் ID-ஐ எப்படிப் பெறுவது?
/business/publish/status/-இல் ஸ்டேட்டஸ் PUBLISH_COMPLETE ஆகி பதிவு பொதுவில் இருக்கும்போது post_ids-இலிருந்து, அல்லது post.publish.publicly_available வெப்ஹூக்கில் உள்ள post_id-இலிருந்து.
TikTok வீடியோவை API வழியாகப் பின்னர் திட்டமிட முடியுமா?
பப்ளிஷ் எண்ட்பாயிண்ட் அழைக்கப்பட்ட நேரத்திலேயே பதிவிடும்; அதில் நேரப் புலம் இல்லை. easyCoexistence திட்டமிட்ட பதிவுகளைத் தனது சொந்த வரிசையில் வைத்து, நீங்கள் அமைத்த நேரத்தில் TikTok-ஐ அழைக்கும்.
தொடர்ந்து படிக்கவும்
உங்கள் முதல் சேனலை இரண்டு நிமிடங்களில் இணையுங்கள்.
காத்திருக்க வேண்டிய தளச் மதிப்பாய்வுகள் எதுவும் இல்லை. WhatsApp, Instagram, TikTok அல்லது வேறொரு சேனலை இணையுங்கள். பிறகு போஸ்ட் செய்ய, பதிலளிக்க அல்லது ரிப்போர்ட் தர உங்கள் AI-யிடம் கேளுங்கள், அது செயல்படுவதைப் பாருங்கள்.
- 3 நாட்கள் இலவசம்
- எப்போது வேண்டுமானாலும் ரத்து செய்யலாம்
- அதிகாரப்பூர்வ API-கள் மட்டுமே
- 24/7 கண்காணிப்பு
இதில் சரிபார்க்கப்பட்டது: