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

איך לבדוק את סטטוס הפרסום של פוסט ב-TikTok דרך ה-API

הפרסום של פוסטים דרך ה-API ב-TikTok הוא אסינכרוני: קריאת הפרסום מחזירה share_id, וקריאת GET /business/publish/status/ עם אותו מזהה בשדה publish_id מציינת היכן הפוסט עומד. הסטטוס הוא PROCESSING_DOWNLOAD בזמן שהקובץ נשלף, PUBLISH_COMPLETE אחרי שהפוסט עבר בקרת תוכן ופורסם, או FAILED עם סיבה, כמו frame_rate_check_failed, שמסבירה מה נכשל.

easyCoexistence מפרסם ב-TikTok באמצעות publish_tiktok_post ועוקב אחרי כל פוסט בעזרת get_tiktok_publish_status, מתוך Claude, ChatGPT או הקוד שלכם, כך שה-AI שלכם רואה את הסטטוס של TikTok ואת סיבת הכשל כפי שהם עומדים כרגע.

3 min

הזמן שעשוי לעבור עד שמזהי הפוסטים מופיעים אחרי PUBLISH_COMPLETE; לפי TikTok, מומלץ לנסות שוב אחרי שלוש דקות אם הם חסרים.

30 min

ההערכה הכללית של TikTok להורדת קובץ פוסט בגודל 1 GB; הזמן בפועל תלוי בגודל הקובץ וברשת.

2 min

משך ההמתנה הרגיל הארוך ביותר, מרגע סיום ההעלאה, עד שפוסט הופך לציבורי; בדיקה ידנית עשויה להימשך זמן רב יותר.

1 hour

פסק הזמן להורדה, שמעבר לו הפוסט נכשל עם video_pull_failed או photo_pull_failed לפי סוג הקובץ.

למה פוסט ב-TikTok צריך מעקב?

הפרסום מתבצע ברקע. קריאת הפרסום מתחילה משימה ומחזירה share_id מיד; אחר כך מורידים את הקובץ מכתובת ה-URL שלו, בודקים את הפורמט, ואז הפוסט עובר בקרת תוכן והופך לציבורי. פוסט עדיין עלול להיכשל גם אחרי שהקריאה עצמה הצליחה.

אילו סטטוסים יש?

הקריאה GET /business/publish/status/ מקבלת את business_id של החשבון ואת share_id בשדה publish_id, ומחזירה אחד מארבעה סטטוסים:

  • PROCESSING_DOWNLOAD: התוכן נמשך כרגע מכתובת ה-URL שלו.
  • PUBLISH_COMPLETE: הפוסט עבר בקרת תוכן ופורסם; השדה post_ids כולל אותו ברגע שהוא גלוי לציבור.
  • FAILED: הפרסום נעצר, והשדה reason מסביר מדוע.
  • SEND_TO_USER_INBOX: הועלתה טיוטה, ונשלחה התראה לתיבת הנכנסות של היוצר; הסטטוס חל על טיוטות בלבד.

כמה זמן לוקח הפרסום?

אין זמן קבוע. ההורדה תלויה בגודל הקובץ וברשת. ההערכה הכללית של TikTok: 30 דקות מספיקות להורדת קובץ של 1 GB, ושעה היא הגבול העליון. אחר כך פוסט הופך לציבורי בדרך כלל תוך 2 דקות, או מאוחר יותר כשנדרשת בקרה ידנית, ומזהה הפוסט עשוי להופיע בסטטוס עד שלוש דקות נוספות אחר כך.

מה משמעות סיבות הכשל?

השדה reason מציין מה עצר את הפוסט. חלק מהסיבות מחייבות לשנות את הקובץ, ואחרות מאפשרות ניסיון חוזר:

  • file_format_check_failed, duration_check_failed, frame_rate_check_failed, picture_size_check_failed: הקובץ שובר כלל פורמט, והסיבות האלה מסומנות כלא ניתנות לניסיון חוזר.
  • video_pull_failed, photo_pull_failed: לא ניתן היה להוריד את הקובץ, או שההורדה לא הסתיימה בתוך השעה; ניסיון חוזר אפשרי אחרי שכתובת ה-URL נגישה לציבור.
  • internal: חלק משירות TikTok לא היה זמין, וניסיון חוזר תקין.
  • spam_risk_too_many_posts, spam_risk, spam_risk_text: הפוסט נעצר בשל נפח הפרסומים, התנהגות או תוכן הכיתוב.
  • auth_removed: החשבון ביטל את הגישה של האפליקציה במהלך העיבוד, והמלצה היא לא לנסות שוב.
  • spam_risk_user_banned_from_posting: לחשבון נחסמה האפשרות לפרסם פוסטים חדשים.

למה צריך את מזהה הפוסט?

כדי למצוא את הפוסט אחר כך. התיעוד של TikTok מעביר מזהי פוסטים אל נקודת הקצה /business/video/list/ בשדה filters.video_ids, כדי לקרוא את המדדים של הפוסטים. קריאות תגובה לוקחות את item_id של הפוסט מרשימת הסרטונים של החשבון בשדה video_id, והכלים של easyCoexistence לתגובות מקבלים אותו בשדה post_id, שזהו מזהה הפוסט.

איך easyCoexistence עוקב אחרי פוסט?

publish_tiktok_post מחזיר את share_id של TikTok עם הערה שהפוסט מעובד, ו-get_tiktok_publish_status מקבל את share_id ומחזיר את הסטטוס של TikTok כפי שהוא עומד כרגע, עם הסיבה כשיש סיבה. מומלץ לבקש מה-AI לבדוק שוב אחרי כמה דקות ולא מיד.

טעויות נפוצות

  • לפרסם שוב כי עוד לא הופיע שום דבר. הקריאה הראשונה רק התחילה את המשימה, ולכן כדאי לבדוק את הסטטוס שלה לפני ששולחים את הפוסט שוב.
  • להתייחס לסטטוס PUBLISH_COMPLETE בלי post_ids כאל שגיאה. המזהים עשויים להתעכב עד שלוש דקות נוספות, ולכן כדאי לבדוק שוב רק אז.
  • לנסות שוב עם אותו קובץ פוסט שנכשל בבדיקת פורמט. בדיקות כאלה, כולל file_format_check_failed, דורשות קובץ מתוקן.
  • לסגור את כתובת ה-URL בזמן ההורדה. כשאי אפשר להביא את הקובץ, הפוסט נכשל עם video_pull_failed או photo_pull_failed לפי סוג הקובץ.
עושים את זה עם EasyCoexistence

US$ 9 עד US$ 0.75 לחיבור בחודש, שיורד ככל שמוסיפים חיבורים, ושלושת הימים הראשונים בחינם.

שאלות נפוצות

מה זה share_id ב-TikTok?

המזהה של משימת פרסום, שמוחזר מנקודות הקצה של פרסום סרטון ותמונה. הוא נשלח לקריאת הסטטוס בשדה publish_id כדי לעקוב אחרי המשימה.

האם יש וובהוק (Webhook) לסטטוס הפרסום ב-TikTok?

כן. אפליקציה שנרשמה עם event_type VIDEO דרך נקודת הקצה /business/webhook/update/ מקבלת את אירועי פרסום הפוסטים של TikTok, כמו post.publish.failed עם הסיבה ועם publish_id, במקום בדיקות סטטוס חוזרות.

למה לפוסט שפורסם אין עדיין מזהה פוסט?

ההחזרה של post_ids יכולה לקחת עד שלוש דקות אחרי PUBLISH_COMPLETE, והם מוחזרים רק לפוסטים שגלויים לציבור.

האם אפשר לנסות שוב פוסט שנכשל ב-TikTok?

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

המשיכו לקרוא

דרישות הסרטון של TikTok ל-API: פורמט, גודל ואורךהסרטונים ש-TikTok API for Business מפרסם: MP4, MOV או WebM, 3 עד 600 שניות, עד 1 GB, 23 עד 60 FPS, מכתובת ש-TikTok מורידה בעצמה.מגבלות הפרסום של TikTok API: כמה פוסטים ביוםכמה פוסטים TikTok API מפרסם לכל חשבון: שישה בדקה ו-15 ביום בנקודות הקצה של וידאו ותמונה, ומה קורה מעבר למכסה.תזמון פוסטים ב-TikTok דרך ה-APIאיך מתוזמנים סרטוני TikTok ופוסטים של תמונות דרך ה-API: תור שמפרסם בתאריך ובשעה שקבעתם, וכללי TikTok ברגע השליחה.אירועי וובהוק של תגובות ב-TikTokכך מדווח וובהוק (Webhook) comment.update של TikTok על תגובות ותשובות, מה כל אירוע כולל, וכיצד הם מגיעים לנקודת הקצה שלכם, חתומים ומיד עם הגעתם.TikTok analytics API: תובנות חשבון ומדדי סרטוניםמדדי TikTok שמחזיר ה-API for Business: עוקבים, צפיות ולייקים לפי יום לחשבון, וצפיות, לייקים, תגובות ושיתופים לכל סרטון.שגיאת TikTok 40007: האובייקט אינו קייםשגיאת TikTok 40007 פירושה שהבקשה מצביעה על אובייקט, כתובת URL או קובץ שאינם קיימים. אילו מזהי Accounts API לבדוק ומאיפה כל אחד מגיע.

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

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

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

נבדק ב-