למה חיבור TikTok API מפסיק לעבוד, ואיך שומרים אותו פעיל
חיבור TikTok API for Business מפסיק לעבוד כשאסימון הגישה בן 24 השעות לא מתחדש, כשאסימון הרענון בן השנה פג, כשהבעלים מסירים את הגישה של האפליקציה, או כשהאסימון שנשלח חסר או שגוי. TikTok מדווח על מקרי האסימון בקודים 40102, 40103, 40104 ו-40105. חידוש מוקדם, בדיקה מתוזמנת של כל חשבון, ובקשה מהבעלים לאשר שוב לפני תום השנה, שומרים על החיבור פעיל.
easyCoexistence שומרת על כל חיבור TikTok פעיל בעצמה: מחדשת את האסימון בן 24 השעות מראש, בודקת את החשבון בערך כל 6 שעות, וכש-TikTok דוחה את האסימון, מסמנת את הערוץ כ-Reconnect needed ושולחת לכם מייל, עבור Claude, ChatGPT או הפלטפורמה שלכם.
משך החיים של אסימון הגישה לחשבון TikTok מה-API for Business; נקודת הקצה /tt_user/oauth2/refresh_token/ מחדשת אותו.
משך החיים של אסימון הרענון; לאחר פקיעתו, בעל החשבון צריך לאשר את האפליקציה מחדש.
סיבת כישלון כשהבעלים מסירים את הגישה של האפליקציה בזמן ש-TikTok מעבד פרסום; TikTok מציין שאין לנסות שוב.
אירועים ש-TikTok מפסיק לשלוח עבור חשבון, לאחר שההרשאה של הבעלים פגה או בוטלה.
מדוע האירוע authorization.removed של TikTok for Developers מופעל: המשתמש מתנתק, החשבון נמחק, גיל משתנה, יש חסימה, או המפתח מבטל.
כל כמה זמן easyCoexistence בודקת כל חשבון TikTok מחובר; היא מחדשת לבד את האסימון בן 24 השעות ושולחת הודעה במייל אם נדרש חיבור מחדש.
למה חיבור TikTok API מפסיק לעבוד?
מסיבות מעטות, רובן קשורות לאסימוני החשבון או להסכמת הבעלים. חלקן מנתקות את החיבור לגמרי, ואחרות משאירות אותו חלקי, כשחלק מהקריאות נדחות והשאר עדיין מגיבות:
איזו שגיאה מחזירה כל סיבה, ומה מתקן אותה?
בשדה code של TikTok מופיעים רוב הקודים, בתוך תשובה עם סטטוס HTTP 200 ולא בקוד שגיאה, וסטטוס הפרסום מוסיף סיבת כישלון משלו. הקוד 40100 מופיע בטבלה כי קריאה שנחסמה בשל הגבלת קצב יכולה להיראות כמו חיבור שאבד. מה כל אחד מהם אומר, והתיקון:
| What it means | The fix | |
|---|---|---|
| 40102 | The access token is past its 24 hours | Renew with the refresh token, store both new tokens, repeat the call |
| 40103 | The refresh token has expired | A new authorization by the owner; nothing renews it |
| 40104 | The request carried no access token | A bug in the request: send the Access-Token header |
| 40105 | The access token is invalid or incorrect | Check what was sent, renew, then ask the owner to authorize again |
| 40107 | The refresh token is invalid or incorrect | Send the refresh token from the latest response, or a new authorization |
| 40131 | Authentication failed at a token endpoint | Check the app ID and secret, then the code or the refresh token |
| 40001 | A permission or scope is missing | Add it to the app, then have the owner authorize again |
| auth_removed | Access was removed while a post was processing | No retry; publish again after a new authorization |
| 40100 | Throttled, not disconnected | Pause the endpoint 5 minutes; the token still works |
כמה זמן חיים האסימונים, ומתי כדאי לחדש?
ב-API for Business, אסימון הגישה חי 24 שעות, ו-expires_in בכל תשובת אסימון מציין את השניות שנותרו; אסימון הרענון חי שנה, עם ספירה לאחור משלו ב-refresh_token_expires_in. מחדשים הרבה לפני סוף היום, לפי לוח זמנים ולא אחרי קריאה שנכשלה, ושומרים את אסימון הרענון שכל חידוש מחזיר, שכן TikTok מציין בהערה לשדה שיש לשמור אותו. יש להתייחס ל-refresh_token_expires_in כמועד יעד: בדוגמת החידוש של TikTok הוא סופר לאחור במקום להתחיל שנה חדשה.
מה קורה כשהבעלים מסירים את הגישה של האפליקציה?
האפליקציה מאבדת את הרשאות ה-Accounts API שהבעלים העניק, כך שקריאות עם האסימון הזה מפסיקות לעבוד, ו-TikTok לא מתעד אירוע API for Business שמודיע על כך. הבעלים יכול לעשות זאת בכל עת באפליקציית TikTok, דרך Settings and privacy, Security, Manage app permissions ואז Remove access, וזו הפעולה שמבטלת את הגישה. הסימנים מופיעים במקום אחר: פרסום ש-TikTok עיבד נכשל עם auth_removed, ש-TikTok מציין שאין לנסות שוב, ואירועי comment.update לחשבון מפסיקים להגיע.
מה שינוי בסוג החשבון עושה לחיבור?
TikTok לא מקשר לזה שום שגיאת אסימון בתיעוד שלו; מה שמשתנה הוא מה שה-API מחזיר. נתונים כמו unique_video_views, daily_new_followers ו-audience_activity דורשים Advanced Access או Verified Business Account, וכך גם Mentions ו-Business Messaging APIs, ו-privacy_level_options של חשבון פרטי משמיט את PUBLIC_TO_EVERYONE. מאז 16 באוקטובר 2026, is_business_account מחזיר true רק עבור Verified Business Account, ו-has_advanced_access מדווח על Advanced Access, ולכן קריאה לשני השדות תחת user.account.type מראה שינוי לפני שקריאה נכשלת בגללו.
איך מזהים חיבור מת לפני שהלקוח מזהה אותו?
בבדיקות שרצות בין אם מישהו מפרסם ובין אם לא:
- קריאה קלה לכל חשבון לפי לוח זמנים, כמו /business/get/ עם השדה username, שמחזירה שגיאת אסימון ברגע שהאסימון מפסיק לעבוד.
- /
tt_user/token_info/get/, שלא דורש הרשאה ומחזיר את היקף ההרשאות של האסימון, כדי לוודא שההרשאות עדיין מכסות את מה שהפיצ'רים קוראים. - המרת
refresh_token_expires_inלתאריך ברגע שכל תשובה מגיעה, עם תזכורת לבעלים שבועות לפני המועד. - שקט באירועי comment.update לחשבון שבדרך כלל מקבל תגובות, שכן TikTok מפסיק את האירועים האלה לאחר שההרשאה פגה או בוטלה.
- קודים 40102, 40103, 40104 ו-40105 שנספרים לכל חשבון, כך שחשבון אחד שנכשל בולט בין רבים.
איך מחברים חשבון מחדש?
מריצים מחדש את האישור לאותו חשבון. משתפים את כתובת האישור של בעל חשבון TikTok, עם ערך state שמקשר את החזרה לחשבון, ו-disable_auto_auth=1 אם הבעלים צריך לראות שוב את דף ההרשאות. מחליפים את auth_code החדש ב-/tt_user/oauth2/token/ בתוך 10 דקות מיצירתו, ואז מחליפים את שני האסימונים השמורים. open_id הוא המזהה הספציפי לאפליקציה לחשבון ב-TikTok, ולכן מתאימים את האסימונים החדשים לרשומה השמורה לפיו, במקום ליצור רשומה שנייה.
האם חיבורי Content Posting API פגים באותו אופן?
לא. TikTok for Developers, שמפעיל את ה-Content Posting ו-Display APIs, עדכן את דפי האסימונים שלו ב-2 בנובמבר 2026: אסימוני גישה של משתמש פגים תוך שעתיים, ואסימוני רענון חיים 180 יום מההנפקה הראשונה. אסימוני הרענון מתחלפים, כך שכל רענון מוצלח מחזיר אחד חדש ומבטל מיד את זה שנשלח, ואם שרת ממשיך להשתמש באסימון שהוחלף, רענונים מאוחרים נכשלים והמשתמש צריך לאשר שוב. אסימון רענון שגוי נכשל עם invalid_grant, אסימון גישה שגוי עם access_token_invalid ו-HTTP 401, ואירוע ה-authorization.removed בוובהוק (Webhook) מסביר מדוע משתמש עזב.
מה easyCoexistence עושה כדי לשמור על חיבור TikTok פעיל?
היא מחדשת ובודקת לבד, ומודיעה כשרק הבעלים יכול לתקן:
- חידוש: לפני קריאה כשנותרו פחות מ-15 דקות, ובמהלך בדיקה כשנותרות פחות מ-8 שעות, ובכל פעם שומרת את אסימון הרענון החדש ואת תאריך פקיעתו.
- חידוש אחד בכל פעם לכל חשבון, כך שקריאות שמגיעות יחד חולקות אותו.
- הבדיקה: קריאה ל-/business/get/ עבור ה-username של החשבון, בערך כל 6 שעות.
- אסימון שנדחה, 40102, 40104 או 40105: הערוץ מציג Reconnect needed, הבעלים מקבל מייל אחד, ופלטפורמה מקבלת את channel.disconnected, וההודעה של TikTok נשמרת בשדה
disconnected_reason, כך שאפשר לראות את הסיבה. - עד אז, הכלים עונים שהחשבון צריך חיבור מחדש, ופרסום מתוזמן נכשל עם הסטטוס reconnect ולא מגיע לשרת של TikTok בכלל.
- מחברים מחדש: לוחצים על Connect TikTok בדף הערוץ, או פותחים סשן חיבור חדש; ההתחברות מחדש שומרת על אותו
account_idועל אותו יעד אירועים.
איך מגדירים
- Store both tokens with datesSave access_token, refresh_token, open_id and scope, and turn expires_in and refresh_token_expires_in into dates as each response arrives.
- Renew ahead of the dayCall /tt_user/oauth2/refresh_token/ well before the 24 hours end, one renewal per account at a time, and keep the refresh token it returns.
- Check each accountMake one light call per account on a schedule and record any 40102, 40103, 40104 or 40105 against that account.
- Ask before the year endsSend the owner the authorization URL before refresh_token_expires_in runs out, and replace both tokens when the new code arrives.
- Reconnect on a token errorWhen renewal fails or the token is refused, stop calling for that account and send its owner the authorization URL.
טעויות נפוצות
- לראות בוובהוק של תגובות שקט כחשבון שקט. TikTok מפסיק לשלוח comment.update לחשבון לאחר שההרשאה שלו מסתיימת, ולכן בודקים את החשבון במקום לחכות לאירועים.
- להתחבר מחדש לתוך רשומה חדשה. מתאימים את האסימונים החדשים לפי open_id, המזהה הספציפי לאפליקציה ב-TikTok, ומעדכנים את הרשומה השמורה במקומה, תוך שמירה על ההיסטוריה וההגדרות שלה.
- לנסות שוב את 40103 או 40107 עם אותו אסימון רענון. אף אחד מהם לא נפתר בניסיון חוזר: הראשון דורש אישור חדש, והשני דורש את אסימון הרענון מהתשובה האחרונה, או אישור חדש.
- לקרוא את 40100 כחיבור שאבד. זו קריאה שנחסמה בשל הגבלת קצב; משהים את נקודת הקצה ל-5 דקות, או עד 00:00 UTC אחרי מכסה יומית, והאסימון הזה ממשיך לעבוד.
US$ 9 עד US$ 0.75 לחיבור לחודש, והמחיר יורד ככל שמוסיפים חיבורים, עם תקופת ניסיון של 3 ימים בחינם.
שאלות נפוצות
האם חיבור TikTok API יכול להישאר פעיל לנצח בלי הבעלים?
לא. החידוש נושא את החיבור לכל היותר לאורך השנה של אסימון הרענון; אחרי זה, הדרך המתועדת של TikTok היא אישור חדש מצד בעל החשבון.
למה חיבורי TikTok נכשלו בבת אחת עבור כמה חשבונות?
קודם בודקים את האפליקציה ורק אחר כך את החשבונות: 40113 אומר שהאפליקציה חסומה או שהמזהה והסוד שלה לא תואמים, ו-TikTok יכול לבטל את הגישה של אפליקציה ל-Accounts API בגלל שימוש לרעה.
האם פיצ'ר חדש אומר לחבר מחדש חשבונות TikTok?
כשהוא דורש היקף הרשאה שהבעלים מעולם לא העניק, כן. אסימון שומר על ההיקפים שאושרו באישור, ולכן הבעלים מאשר שוב את האפליקציה כדי להוסיף היקף אחד.
מה קורה לפרסומי TikTok מתוזמנים בזמן שחשבון צריך חיבור מחדש?
ב-easyCoexistence הם נכשלים עם הסטטוס reconnect בזמן שלהם ולא מגיעים ל-TikTok, הבעלים מקבל מייל, ו-Retry שולח אותם אחרי שהחשבון מחובר שוב.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-