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

למה חיבור TikTok API מפסיק לעבוד, ואיך שומרים אותו פעיל

חיבור TikTok API for Business מפסיק לעבוד כשאסימון הגישה בן 24 השעות לא מתחדש, כשאסימון הרענון בן השנה פג, כשהבעלים מסירים את הגישה של האפליקציה, או כשהאסימון שנשלח חסר או שגוי. TikTok מדווח על מקרי האסימון בקודים 40102, 40103, 40104 ו-40105. חידוש מוקדם, בדיקה מתוזמנת של כל חשבון, ובקשה מהבעלים לאשר שוב לפני תום השנה, שומרים על החיבור פעיל.

easyCoexistence שומרת על כל חיבור TikTok פעיל בעצמה: מחדשת את האסימון בן 24 השעות מראש, בודקת את החשבון בערך כל 6 שעות, וכש-TikTok דוחה את האסימון, מסמנת את הערוץ כ-Reconnect needed ושולחת לכם מייל, עבור Claude, ChatGPT או הפלטפורמה שלכם.

24 hours

משך החיים של אסימון הגישה לחשבון TikTok מה-API for Business; נקודת הקצה /tt_user/oauth2/refresh_token/ מחדשת אותו.

1 year

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

auth_removed

סיבת כישלון כשהבעלים מסירים את הגישה של האפליקציה בזמן ש-TikTok מעבד פרסום; TikTok מציין שאין לנסות שוב.

comment.update

אירועים ש-TikTok מפסיק לשלוח עבור חשבון, לאחר שההרשאה של הבעלים פגה או בוטלה.

5 reasons

מדוע האירוע authorization.removed של TikTok for Developers מופעל: המשתמש מתנתק, החשבון נמחק, גיל משתנה, יש חסימה, או המפתח מבטל.

6 hours

כל כמה זמן easyCoexistence בודקת כל חשבון TikTok מחובר; היא מחדשת לבד את האסימון בן 24 השעות ושולחת הודעה במייל אם נדרש חיבור מחדש.

למה חיבור TikTok API מפסיק לעבוד?

מסיבות מעטות, רובן קשורות לאסימוני החשבון או להסכמת הבעלים. חלקן מנתקות את החיבור לגמרי, ואחרות משאירות אותו חלקי, כשחלק מהקריאות נדחות והשאר עדיין מגיבות:

Access token expired24 hours passed without a renewal, and calls return 40102
Refresh token expiredIts year ended: renewal returns 40103 until the owner signs in again
Access removedThe owner chose Remove access in TikTok, or the app revoked the token
Wrong tokenMissing from the request (40104), or invalid or incorrect (40105)
Missing permissionA call outside the granted permissions returns 40001
Account level changedData tied to Advanced Access or verification is no longer available
App access revokedTikTok can revoke an app's Accounts API access for misuse, without notice

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

בשדה code של TikTok מופיעים רוב הקודים, בתוך תשובה עם סטטוס HTTP 200 ולא בקוד שגיאה, וסטטוס הפרסום מוסיף סיבת כישלון משלו. הקוד 40100 מופיע בטבלה כי קריאה שנחסמה בשל הגבלת קצב יכולה להיראות כמו חיבור שאבד. מה כל אחד מהם אומר, והתיקון:

What it meansThe fix
40102The access token is past its 24 hoursRenew with the refresh token, store both new tokens, repeat the call
40103The refresh token has expiredA new authorization by the owner; nothing renews it
40104The request carried no access tokenA bug in the request: send the Access-Token header
40105The access token is invalid or incorrectCheck what was sent, renew, then ask the owner to authorize again
40107The refresh token is invalid or incorrectSend the refresh token from the latest response, or a new authorization
40131Authentication failed at a token endpointCheck the app ID and secret, then the code or the refresh token
40001A permission or scope is missingAdd it to the app, then have the owner authorize again
auth_removedAccess was removed while a post was processingNo retry; publish again after a new authorization
40100Throttled, not disconnectedPause 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 ועל אותו יעד אירועים.

איך מגדירים

  1. 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.
  2. 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.
  3. Check each accountMake one light call per account on a schedule and record any 40102, 40103, 40104 or 40105 against that account.
  4. 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.
  5. 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 אחרי מכסה יומית, והאסימון הזה ממשיך לעבוד.
עושים את זה עם EasyCoexistence

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

שאלות נפוצות

האם חיבור TikTok API יכול להישאר פעיל לנצח בלי הבעלים?

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

למה חיבורי TikTok נכשלו בבת אחת עבור כמה חשבונות?

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

האם פיצ'ר חדש אומר לחבר מחדש חשבונות TikTok?

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

מה קורה לפרסומי TikTok מתוזמנים בזמן שחשבון צריך חיבור מחדש?

ב-easyCoexistence הם נכשלים עם הסטטוס reconnect בזמן שלהם ולא מגיעים ל-TikTok, הבעלים מקבל מייל, ו-Retry שולח אותם אחרי שהחשבון מחובר שוב.

המשיכו לקרוא

אסימוני גישה ל-TikTok API for Business: 24 שעות, רענון וביטולאיך TikTok API for Business מנפיק אסימוני חשבון: החלפת auth_code, אסימון גישה ל-24 שעות, אסימון רענון לשנה, חידוש וביטול.אוטומציה ב-TikTok: מה מגביל חשבונות, API רשמי מול בוטיםמה תנאי TikTok והנחיות הקהילה שלה אומרים על אוטומציה, למה בוטים לא רשמיים מגבילים חשבונות, ואיך לאוטומט בתוך הכללים.TikTok API ב-Python וב-Node.js: דוגמאות עבודהדוגמאות עבודה ל-TikTok API for Business ב-Python וב-Node.js: פרסום וידאו ותמונות, מעקב, רשימת סרטונים, מענה לתגובות, תובנות, וובהוק (Webhook).איך מחברים חשבון TikTok ל-API או לסוכן AIאיך חשבון TikTok מתחבר ל-API או לסוכן AI: מסך ההרשאה של TikTok, ההרשאות לאישור, זרימת לוח הבקרה וקישורי החיבור.הרשאות ב-TikTok API for Business: מה פותחת כל הרשאהההרשאות ש-TikTok Accounts API עובד איתן, לפי השמות של TikTok: מה כל הרשאה פותחת, היקפי האסימון לכל שדה ואיך בודקים אסימון.מדריך TikTok API ל-2026: מהאפליקציה שלכם ועד הפוסט הראשוןמסלול ה-TikTok API ב-2026 לפי הסדר: איזה API, בדיקת אפליקציה, הרשאות, אסימונים, פרסום, סטטוס, תגובות, וובהוקים, נתונים ומגבלות.

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

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

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

נבדק ב-