שליחת סרטון לטיוטות של יוצר ב-TikTok דרך ה-API
ה-APIs של TikTok שולחים סרטון לטיוטות של יוצר בזרימת ההעלאה: נקודת הקצה /v2/post/publish/inbox/video/init/ של Content Posting API מעלה אותו תחת ההרשאה video.upload, ו-TikTok שולח ליוצר התראה בתיבת הדואר הנכנס כדי שיערוך ויפרסם אותו באפליקציה. ה-API for Business עושה את אותו הדבר עם upload_to_draft בנקודת /business/video/publish/, או עם is_draft בפוסטים של תמונות.
easyCoexistence מפרסם סרטוני TikTok ופוסטים של תמונות עם publish_tiktok_post מתוך Claude, ChatGPT או הפלטפורמה שלכם, עכשיו או בתאריך ושעה עד 90 יום קדימה, וכל פוסט בתור מופיע במסך Posts עד שייצא.
ההרשאה ש-TikTok מגדיר: שיתוף תוכן לחשבון היוצר כטיוטה, לעריכה ופרסום נוסף ב-TikTok.
מספר השיתופים הממתינים המרבי ש-Content Posting API מאפשר בכל תקופה של 24 שעות, מגבלה ש-TikTok קבע כדי להפחית ספאם.
הסטטוס /business/publish/status/ מדווח כשטיוטה הועלתה ו-TikTok שלח התראה לתיבת הדואר הנכנס של היוצר.
הבקשות שכל אסימון גישה (Access Token) של משתמש יכול לשלוח לנקודת ההעלאה של Content Posting API.
מה קורה לשאר שדות post_info כאשר upload_to_draft הוא true בנקודת /business/video/publish/.
במה טיוטה שונה מפרסום ישיר?
בשאלה מי לוחץ על פרסום. פוסט ישיר עולה לאוויר ברגע ש-TikTok מעבד אותו; טיוטה נוחתת בתיבת הדואר הנכנס של היוצר ומתפרסמת רק כשהיוצר פותח אותה, עורך לפי רצונו ומפרסם. ההבדל עובר דרך שני ממשקי הפרסום של TikTok:
| 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 |
איך Content Posting API מעלה טיוטה?
בבקשת POST אל https://open.tiktokapis.com/v2/post/publish/inbox/video/init/, עם אסימון גישה של משתמש שמחזיק בהרשאה video.upload ואובייקט source_info. PULL_FROM_URL גורם ל-TikTok למשוך את הסרטון מדומיין או מקידומת כתובת שהאפליקציה אימתה; FILE_UPLOAD מחזיר upload_url, ואליו הקובץ נשלח בחלקים בבקשות PUT. ה-publish_id שמוחזר נשלח אל /v2/post/publish/status/fetch/, תמונות משתמשות ב-/v2/post/publish/content/init/ עם post_mode שמוגדר ל-MEDIA_UPLOAD, ו-TikTok מבקש מהאפליקציות לומר למשתמשים לפתוח את ההתראה בתיבת הדואר הנכנס כדי להמשיך לערוך ב-TikTok:
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/אילו מגבלות חלות על טיוטות של Content Posting API?
TikTok מתעד אותן בעמוד ההעלאה שלו, וכל אחת מוחזרת על ידי קריאת ה-init כשהיא חלה:
- טיוטות ממתינות: לכל היותר 5 שיתופים ממתינים בכל תקופה של 24 שעות; מעבר לכך,
spam_risk_too_many_pending_shareעם HTTP 403. - בקשות: 6 בדקה לכל אסימון גישה של משתמש, ואז
rate_limit_exceededעם HTTP 429. - הרשאה: אסימון בלי video.upload מקבל
scope_not_authorizedעם HTTP 401. - מדיה:
PULL_FROM_URLמדומיין או מקידומת שהאפליקציה לא אימתה מקבלurl_ownership_unverifiedעם HTTP 403.
איך ה-API for Business מעלה טיוטה?
דרך נקודות הפרסום שלו ושדה נוסף אחד בתוך post_info. בנקודת /business/video/publish/, upload_to_draft שמוגדר ל-true שולח את הסרטון כטיוטה, וTikTok מתעלם משאר שדות post_info; בנקודת /business/photo/publish/, is_draft משאיר רק את הכותרת והכיתוב. שניהם דורשים video.upload באסימון של החשבון, שמפורט ב-/tt_user/token_info/get/, ואם חסרה ההרשאה הבעלים מאשר העלאת טיוטות על ידי אישור מחדש של האפליקציה. המדיה נשארת על כתובת מאומתת, הסטטוס הוא SEND_TO_USER_INBOX, והיוצר מוצא את הטיוטה דרך ההתראה בתיבת הדואר הנכנס:
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
}
}'מה היוצר עושה עם הטיוטה?
מסיים אותה ב-TikTok. ההתראה בתיבת הדואר הנכנס פותחת את הסרטון או התמונות שהועלו בעורך של TikTok, שבו היוצר בודק, עורך ומפרסם. ב-Content Posting API, הסטטוס עובר מ-SEND_TO_USER_INBOX ל-PUBLISH_COMPLETE כשהיוצר מפרסם מהטיוטה, ו-TikTok מציין שטיוטה אחת יכולה להניב יותר מפוסט אחד.
האם easyCoexistence שולח טיוטות?
לא: publish_tiktok_post מפרסם. הוא קורא לנקודת /business/video/publish/ או /business/photo/publish/ בלי upload_to_draft או is_draft, ולכן פוסט עולה לאוויר ברגע ש-TikTok מעבד אותו. כדי לעכב פוסט לבדיקה, מתזמנים אותו עם scheduled_at, מדקה אחת ועד 90 יום קדימה: הוא ממתין תחת Coming up במסך Posts, update_scheduled_post משנה את הזמן, הכיתוב או הכותרת של פוסט תמונה, ו-cancel_scheduled_post עוצר אותו לפני שיצא.
טעויות נפוצות
- לבקש את video.publish כדי לשלוח טיוטות. טיוטות דורשות את video.upload, ההרשאה שמתארת שיתוף תוכן כטיוטה.
- להגדיר כיתוב לטיוטת סרטון דרך API for Business. כאשר upload_to_draft שווה true, TikTok מתעלם משאר שדות post_info.
- להעלות טיוטות מהר יותר ממה שהיוצרים מפרסמים. Content Posting API עוצר ב-5 שיתופים ממתינים בתוך 24 שעות עם spam_risk_too_many_pending_share.
- להשאיר משתמשים בלי הפניה לתיבת הדואר הנכנס. TikTok מבקש מהאפליקציות לומר להם לפתוח את ההתראה בתיבת הדואר הנכנס כדי לסיים את הפוסט.
US$ 9 עד US$ 0.75 לחיבור בחודש, יורד ככל שמוסיפים חיבורים, עם תקופת ניסיון של 3 ימים.
שאלות נפוצות
האם ה-API של TikTok יכול לשמור סרטון כטיוטה?
כן. זרימת ההעלאה שולחת אותו לתיבת הדואר הנכנס של היוצר ב-TikTok, שם היוצר עורך ומפרסם; האסימון צריך את ההרשאה video.upload.
היכן מופיעה טיוטה שנשלחה דרך ה-API?
באפליקציית TikTok, מאחורי התראה בתיבת הדואר הנכנס שפותחת את הסרטון בעורך של TikTok כדי שהיוצר יסיים אותו.
האם טיוטת TikTok יכולה לשמור על הכיתוב שלי?
ב-API for Business, טיוטת תמונה שומרת על הכותרת והכיתוב שלה, בעוד טיוטת סרטון מוותרת על שאר שדות post_info.
האם טיוטה אחת של TikTok יכולה להפוך ליותר מפוסט אחד?
כן. TikTok מציין שטיוטה אחת יכולה להניב יותר מפוסט אחד, וב-Content Posting API הסטטוס עובר ל-PUBLISH_COMPLETE כשהיוצר מפרסם ממנה.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-