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

כשלי פרסום ב-TikTok: spam_risk_too_many_posts, picture_size_check_failed ושאר סיבות הכשל

TikTok מציינת את סיבת הכשל של פוסט בשדה reason בנקודת הקצה של הסטטוס ב-API for Business, או בשדה fail_reason ב-Content Posting API. כשלי בדיקה כמו picture_size_check_failed משמעותם שהקובץ שובר כלל פורמט ודורש שינוי; video_pull_failed משמעותו ש-TikTok לא הצליחה להוריד אותו תוך שעה; spam_risk_too_many_posts משמעותו יותר מדי פוסטים דרך ה-API ב-24 שעות. כשל המסומן internal אפשר פשוט לנסות אותו שוב.

easyCoexistence עוקבת אחרי כל פוסט של TikTok שהיא מפרסמת, עד ש-TikTok משלימה אותו או מכשילה אותו, בין אם זה עבור Claude, ChatGPT או פלטפורמה משלכם.

reason

השדה בנקודת הקצה /business/publish/status/ מוחזר רק כשהסטטוס הוא FAILED, עם ערכים כמו frame_rate_check_failed.

fail_reason

השם של אותו שדה ב-Content Posting API, בתגובות של /v2/post/publish/status/fetch/

1 hour

זמן הורדה מקסימלי, שאחריו TikTok מכשילה פוסט עם video_pull_failed או photo_pull_failed

24 hours

חלון הזמן שמאחורי spam_risk_too_many_posts: TikTok מציעה לפרסם את אותו פוסט מאפליקציית המובייל שלה במקום.

3 hours

בדרך כלל easyCoexistence שולחת לבעל החשבון מייל על פוסטים שנכשלו בערוץ אחד, והפוסט ממתין תחת Needs attention

היכן TikTok מדווחת מדוע פוסט נכשל?

אחרי קריאת הפרסום, שרק מתחילה את המשימה, והקוד 0 שלה אומר ש-TikTok קיבלה אותה, ולא שהפוסט יעלה לאוויר. GET /business/publish/status/ מחזיר אז FAILED עם reason, ואפליקציה שנרשמה לוובהוק (Webhook) של פרסום מקבלת post.publish.failed עם אותה סיבה ועם publish_id. ב-/v2/post/publish/status/fetch/ של Content Posting API השדה מוחזר כשדה fail_reason:

A failed post in /business/publish/status/, from TikTok's example
{
  "code": 0,
  "message": "OK",
  "request_id": "<REQUEST_ID>",
  "data": {
    "reason": "frame_rate_check_failed",
    "status": "FAILED"
  }
}

מה כל סיבת כשל אומרת, ומה מתקן אותה?

הסיבות של TikTok, כפי שמתוארות במסמך ההפניה לאירועי פרסום הפוסטים שלה, לצד התיקון שאליו כל אחת מפנה. ארבע הראשונות הן בדיקות ש-TikTok מריצה על הקובץ אחרי ההורדה, וכולן מסומנות כלא ניתנות לניסיון חוזר. בטבלת הכשלים של TikTok עדיין מופיעות 60 שניות כאורך הסרטון המרבי ל-duration_check_failed, בעוד נקודת הקצה של הסרטונים מתעדת 600, או הערך max_video_post_duration_sec של החשבון עצמו:

What TikTok foundThe fix
file_format_check_failedThe file's format breaks TikTok's specificationsMP4, MOV or WebM video; JPG, JPEG or WebP photos
duration_check_failedThe video's length is outside the limitsAt least 3 seconds, within the account's maximum
frame_rate_check_failedBelow 23 or above 60 frames per secondExport at 23 to 60 FPS
picture_size_check_failedHeight or width under 360 pixelsAt least 360 pixels on each side
video_pull_failed, photo_pull_failedThe download failed or ran past one hourA public URL that is not bandwidth-limited, then a retry
internalPart of TikTok's service was unavailableA retry
auth_removedThe owner removed the app's access mid-processingNo retry; the owner authorizes the app again
spam_risk_too_many_postsToo many API posts in the last 24 hoursPosting from the TikTok mobile app, or waiting
spam_risk_user_banned_from_postingThe account is banned from making new postsNo retry while the account cannot post
spam_risk_textThe caption reads as risky or spammyNew text before posting again
spam_riskHigh spam risk, such as attempts made too oftenNo retry, as TikTok advises
publish_cancelledThe upload or download was cancelledPublishing again if the post is still wanted

אילו כשלים אפשר לנסות שוב?

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

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

במה כשלי Content Posting API שונים?

אותן סיבות, אבל עם שדה ונקודת קצה אחרים, וסירובים שמגיעים לפני שהעיבוד מתחיל. /v2/post/publish/status/fetch/ מחזיר fail_reason, מאפשר 30 בקשות בדקה לכל אסימון משתמש, ומוסיף הנחיה לא לנסות שוב עבור spam_risk_user_banned_from_posting ו-spam_risk_text. כמה סירובים מגיעים במקום זאת בקריאת האתחול, עם HTTP 403:

  • spam_risk_too_many_posts: היוצר הגיע למכסת הפוסטים היומית של ה-API.
  • unaudited_client_can_only_post_to_private_accounts: אפליקציה שלא עברה ביקורת ניסתה לפרסם לחשבון ציבורי.
  • url_ownership_unverified: PULL_FROM_URL מדומיין או מקידומת שהאפליקציה לא אימתה.
  • privacy_level_option_mismatch: privacy_level חסר או מחוץ לאפשרויות של היוצר.
  • reached_active_user_cap: האפליקציה הגיעה למכסה היומית של משתמשים פעילים לפרסום.

מה נכשל לפני ש-TikTok רואה את הפוסט?

מה ש-easyCoexistence יכולה לתפוס ראשונה, עם הודעה משלה במקום סיבה של TikTok. המדיה של פוסט מתוזמן מועתקת בעת התזמון, וקישור שמחזיר דף אינטרנט, שגיאה 404, סוג שגוי, או קובץ מעל 30 MB לתמונה או 1 GB לסרטון נדחה כבר אז. קישורי תמונה שמסתיימים ב-.png, .gif, .bmp, .heic, .avif או .svg נדחים לפני ששום דבר נשלח, ערוץ שדורש חיבור מחדש בזמן הפרסום נכשל כ-reconnect, והסרת ערוץ מבטלת את הפוסטים המתוזמנים שלו.

איך easyCoexistence מדווחת על פוסט TikTok שנכשל?

דרך תור הפרסום שלה, שעוקב אחרי כל פוסט של TikTok אחרי קריאת הפרסום ובודק את /business/publish/status/ בערך כל 20 שניות עד PUBLISH_COMPLETE. סטטוס FAILED מכשיל את הפוסט, והשגיאה שלו מציינת את סיבת TikTok בסוגריים, כמו frame_rate_check_failed, ולכל כשל יש failure_kind:

  • refused: TikTok ענתה לא, כמו בסטטוס FAILED עם הסיבה שלו.
  • uncertain: לקריאת הפרסום לא הגיעה תשובה ברורה, או ש-TikTok לא אישרה תוך שעתיים, ולכן הפוסט עשוי להיות כבר באוויר (may_be_published).
  • reconnect: TikTok דחתה את האסימון של החשבון, והחשבון צריך כניסה חדשה.
  • internal: easyCoexistence נכשלה לפני שמסרה את הפוסט הלאה, ולכן שום דבר לא יצא.

איך מוצאים ומנסים שוב פוסט שנכשל?

בעל החשבון מקבל מייל על כשל שנמצא ברקע, לכל היותר אחד לכל ערוץ בכל 3 שעות, וכתובת האירועים של הפלטפורמה מקבלת post.failed. הפוסט מופיע תחת Needs attention במסך Posts, עם Retry, Reconnect ו-Dismiss, והכלי list_scheduled_posts מחזיר אותו ל-Claude או ל-ChatGPT. retry_scheduled_post מפרסם אותו שוב, עכשיו, מהקבצים שנשמרים 7 ימים אחרי כשל. כאשר השדה may_be_published הוא true, בודקים קודם את list_social_posts, ומעבירים את confirm רק אם הפוסט חסר. פוסט שצריך קובץ או כיתוב חדש מתוזמן מחדש במקום זאת.

Failed posts through MCP
list_scheduled_posts { "account_id": "<ACCOUNT_ID>", "status": ["failed"] }

retry_scheduled_post { "post_id": "<POST_ID>" }

// may_be_published is true and the post is not on the account
retry_scheduled_post { "post_id": "<POST_ID>", "confirm": true }

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

  • ניסיון חוזר של בדיקה כושלת עם אותו קובץ. TikTok מסמנת את כשלי הפורמט, משך הזמן, קצב הפריימים וגודל התמונה כלא ניתנים לניסיון חוזר.
  • ניסיון חוזר מיידי של spam_risk_too_many_posts. TikTok סופרת פוסטים שנעשו דרך ה-API מעל 24 שעות ומציעה לפרסם מאפליקציית המובייל.
  • ניסיון חוזר לפוסט שמסומן may_be_published בלי לבדוק. TikTok אולי כבר פרסמה אותו; בדקו את הפוסטים האחרונים של החשבון, אחרת הוא יוצא פעמיים.
  • חיפוש fail_reason ב-API for Business. נקודת הקצה של הסטטוס שם את השדה reason, והשדה fail_reason שייך ל-Content Posting API
עושים את זה עם EasyCoexistence

כשל מגיע עם הסיבה של TikTok במייל, במסך Posts וכאירוע post.failed, מוכן לניסיון חוזר. US$ 9 עד US$ 0.75 לחיבור בחודש, והמחיר יורד ככל שמוסיפים חיבורים, עם תקופת ניסיון של 3 ימים בחינם.

שאלות נפוצות

מה משמעות picture_size_check_failed ב-TikTok?

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

מה זה video_pull_failed?

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

כמה זמן נמשך spam_risk_too_many_posts?

TikTok סופרת פוסטים שנעשו דרך ה-API ב-24 השעות האחרונות, כ-15 ביום לכל חשבון, ובינתיים מציעה לפרסם מאפליקציית המובייל של TikTok.

האם easyCoexistence מנסה שוב לבד פוסט של TikTok שנכשל?

לא, אחרי ש-TikTok מדווחת FAILED: הפוסט ממתין תחת Needs attention ובעל החשבון מקבל מייל, ו-Retry או retry_scheduled_post שולחים אותו שוב.

המשיכו לקרוא

איך לבדוק את סטטוס הפרסום של פוסט ב-TikTok דרך ה-APIאיך עוקבים אחר פוסט ב-TikTok שפורסם דרך ה-API: השדה share_id, הסטטוסים, מזהי הפוסטים וסיבות הכשל.מגבלות הפרסום של TikTok API: כמה פוסטים ביוםכמה פוסטים TikTok API מפרסם לכל חשבון: שישה בדקה ו-15 ביום בנקודות הקצה של וידאו ותמונה, ומה קורה מעבר למכסה.כתובות URL של מדיה ב-TikTok: דומיינים מאומתים וקידומות URLאיך ה-API for Business של TikTok שולף מדיה מדומיינים ומקידומות URL מאומתים: דרך API for Business, עם רשומת DNS TXT וקובץ חתימה.פוסטים של תמונות וקרוסלות ב-TikTok דרך ה-API: עד 35 תמונותאיך ה-API for Business של TikTok מפרסם פוסט תמונות: 1 עד 35 קבצי JPEG או WebP עד 20 MB כל אחד, כותרת, כיתוב ותמונת שער.שליחת סרטון לטיוטות של יוצר ב-TikTok דרך ה-APIהסבר על שליחת סרטון לטיוטות של יוצר ב-TikTok דרך ה-API: זרימת ההעלאה, upload_to_draft, is_draft וההרשאה video.upload.למה פוסטים דרך ה-API של TikTok פרטיים: unaudited_client_can_only_post_to_private_accountsלמה פוסטים דרך TikTok נשארים פרטיים עד שהאפליקציה עוברת ביקורת, מה אומרת שגיאת 403, ואיך ה-API for Business שונה.

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

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

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

נבדק ב-