התחברותהתחילו תקופת ניסיון
easyCoexistence ממשקי API רשמיים

שליחת סרטון לטיוטות של יוצר ב-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 עד שייצא.

video.upload

ההרשאה ש-TikTok מגדיר: שיתוף תוכן לחשבון היוצר כטיוטה, לעריכה ופרסום נוסף ב-TikTok.

5 pending

מספר השיתופים הממתינים המרבי ש-Content Posting API מאפשר בכל תקופה של 24 שעות, מגבלה ש-TikTok קבע כדי להפחית ספאם.

SEND_TO_USER_INBOX

הסטטוס /business/publish/status/ מדווח כשטיוטה הועלתה ו-TikTok שלח התראה לתיבת הדואר הנכנס של היוצר.

6 a minute

הבקשות שכל אסימון גישה (Access Token) של משתמש יכול לשלוח לנקודת ההעלאה של Content Posting API.

Ignored

מה קורה לשאר שדות post_info כאשר upload_to_draft הוא true בנקודת /business/video/publish/.

במה טיוטה שונה מפרסום ישיר?

בשאלה מי לוחץ על פרסום. פוסט ישיר עולה לאוויר ברגע ש-TikTok מעבד אותו; טיוטה נוחתת בתיבת הדואר הנכנס של היוצר ומתפרסמת רק כשהיוצר פותח אותה, עורך לפי רצונו ומפרסם. ההבדל עובר דרך שני ממשקי הפרסום של TikTok:

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

איך 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:

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/

אילו מגבלות חלות על טיוטות של 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, והיוצר מוצא את הטיוטה דרך ההתראה בתיבת הדואר הנכנס:

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
    }
  }'

מה היוצר עושה עם הטיוטה?

מסיים אותה ב-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 מבקש מהאפליקציות לומר להם לפתוח את ההתראה בתיבת הדואר הנכנס כדי לסיים את הפוסט.
עושים את זה עם EasyCoexistence

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 כשהיוצר מפרסם ממנה.

המשיכו לקרוא

הגדרות פוסט ב-TikTok דרך ה-API: פרטיות, תגובות, Duet ו-Stitchההגדרות שנקודות הקצה לפרסום של TikTok מקבלות: פרטיות, תגובות, Duet, Stitch, תמונת שער, תוויות מותג ו-AI, והערכים שכל חשבון מאפשר.איך לבדוק את סטטוס הפרסום של פוסט ב-TikTok דרך ה-APIאיך עוקבים אחר פוסט ב-TikTok שפורסם דרך ה-API: השדה share_id, הסטטוסים, מזהי הפוסטים וסיבות הכשל.למה פוסטים דרך ה-API של TikTok פרטיים: unaudited_client_can_only_post_to_private_accountsלמה פוסטים דרך TikTok נשארים פרטיים עד שהאפליקציה עוברת ביקורת, מה אומרת שגיאת 403, ואיך ה-API for Business שונה.איך מעלים סרטון ל-TikTok דרך ה-APIפרסמו סרטון ב-TikTok עם ה-API לעסקים: נקודת הקצה לפרסום, גוף ה-JSON, המזהה share_id שמוחזר והקריאה לסטטוס, ב-curl וב-Python.כתובות URL של מדיה ב-TikTok: דומיינים מאומתים וקידומות URLאיך ה-API for Business של TikTok שולף מדיה מדומיינים ומקידומות URL מאומתים: דרך API for Business, עם רשומת DNS TXT וקובץ חתימה.כשלי פרסום ב-TikTok: spam_risk_too_many_posts, picture_size_check_failed ושאר סיבות הכשלמה משמעות סיבות הכשל של פרסום ב-TikTok ואיך מתקנים אותן: spam_risk_too_many_posts, picture_size_check_failed, video_pull_failed ועוד.

מחברים את הערוץ הראשון שלכם תוך שתי דקות.

בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.

  • 3 ימי ניסיון חינם
  • ביטול בכל עת
  • רק ממשקי API רשמיים
  • ניטור 24/7

נבדק ב-