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

שגיאת TikTok 40002: שגיאת פרמטר בבקשה

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

easyCoexistence מוסיף business_id לכל קריאה של TikTok שהיא מבצעת בשביל Claude, ChatGPT או הקוד שלכם, ובודק פרסום לפני השליחה: וידאו או 1 עד 35 תמונות, בקישורי HTTPS, כשתמונות PNG נדחות כי TikTok מקבלת רק JPEG או WebP.

40002

קוד ההחזרה של TikTok לשגיאת פרמטר, עם הפרטים בתוך הודעת התגובה.

HTTP 200

הסטטוס של התגובה לדוגמה של TikTok ל-40002: שדה הקוד, ולא הסטטוס, מראה את הכשל.

2,200

אורך הכיתוב של סרטון, בתווים שנספרים ב-UTF-16, שאפשר להעביר דרך Accounts API, כולל עד 30 תיוגים.

1 to 30

מספר התגובות בעמוד ש-/business/comment/list/ מקבל ב-max_count, וברירת המחדל היא 20.

60 days

כמה רחוק אחורה יכול להגיע start_date כשהקריאה /business/get/ קוראת תובנות של חשבון.

מה משמעות שגיאה 40002?

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

איך קוראים את התגובה?

מתחילים מההודעה, שמציינת את השדה. הדוגמה של TikTok עצמה, למטה, חוזרת עם HTTP 200 וההודעה "Missing required field(s): account_id." דוגמה נוספת בנספח היא "Time format should be %Y-%m-%dT%H:%M." שמרו גם את request_id, כי התיעוד של TikTok מבקש אותו בדיווחי תקלות.

TikTok's example 40002 response
HTTPS/1.1 200 OK
{
    "code": 40002,
    "message": "Missing required field(s): account_id.",
    "request_id": "2022110918305001025108614416C7CC00"
}

אילו כללים של Accounts API שווה לבדוק?

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

  • בכל קריאה: השדה business_id, שמקבל את open_id שחזר יחד עם אסימון הגישה של החשבון.
  • פרסומי וידאו: שני השדות video_url, post_info. post_info נדרש גם כשהוא ריק; כיתובים מכילים עד 2,200 תווים.
  • פרסומי תמונות: עד 35 כתובות ה-URL של תמונות בשדה photo_images, ערך privacy_level שהחשבון מתיר, וכותרת של עד 90 תווים.
  • תגובות: video_id הוא item_id של פרסום מתוך /business/video/list/; max_count נע בין 1 ל-30; comment_ids מקבל עד 30.
  • תשובות לתגובות: טקסט של עד 1,200 תווים, או תמונה במקומו.
  • תובנות: תאריכים בפורמט כמו 2021-06-01, לפי UTC, ולא יותר מ-60 ימים אחורה.

איך מתקנים את זה?

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

מה לגבי בעיות בקובץ המדיה?

הבעיות האלה מדווחות על ידי TikTok אחרי הקריאה. נקודות הקצה לפרסום מחזירות share_id למשימת הפרסום בזמן ש-TikTok מורידה את הקובץ, וכשהקובץ מפר כלל, /business/publish/status/ מציג FAILED עם סיבה כמו file_format_check_failed, frame_rate_check_failed או picture_size_check_failed. הסיבות האלה מסומנות על ידי TikTok כלא ניתנות לניסיון חוזר, ולכן הקובץ עצמו חייב להשתנות.

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

  • שליחה חוזרת של אותה בקשה. 40002 מתארת את הפרמטרים, ולכן שום דבר לא ישתנה עד שמתקנים את השדה שההודעה מציינת.
  • כתיבת פרמטרים של מערך כטקסט רגיל. שדות כמו fields נשלחים כמערכי JSON, כמו בדוגמה של TikTok: ["display_name", "profile_image"].
  • שימוש בהגדרת פרטיות אחת לכל החשבונות. האפשרויות שונות בין חשבונות ציבוריים לפרטיים, ולכן קודם קוראים את privacy_level_options בנקודת הקצה /business/video/settings/.
  • שליחת disable_comment עם הערך false בחשבון שבו התגובות כבויות. כאשר הערך של comment_disabled הוא true, מתקבל רק הערך true.
עושים את זה עם EasyCoexistence

כשעדיין מוחזר 40002 מ-TikTok, הכלי מחזיר את הקוד ואת ההודעה, כדי שה-AI שלכם יוכל לתקן את השדה וליצור ניסיון חוזר. US$ 9 עד US$ 0.75 לכל חיבור בחודש, כשהמחיר יורד ככל שמוסיפים חיבורים, עם 3 הימים הראשונים בחינם.

שאלות נפוצות

מה זו שגיאת פרמטר ב-TikTok API?

זהו קוד ההחזרה 40002: שדה בבקשה חסר, שגוי, לא נתמך או לא תואם לשדה אחר, וההודעה מציינת איזה.

מדוע TikTok שולחת שגיאה 40002 עם HTTP 200?

קודי ההחזרה של TikTok גוברים על סטטוס ה-HTTP, ולכן תגובה 200 שהקוד בה אינו 0 היא עדיין קריאה שנכשלה.

האם כדאי לנסות שוב אחרי שגיאה 40002?

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

איפה מופיעות בעיות בקובץ הוידאו?

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

המשיכו לקרוא

שגיאת TikTok 40007: האובייקט אינו קייםשגיאת TikTok 40007 פירושה שהבקשה מצביעה על אובייקט, כתובת URL או קובץ שאינם קיימים. אילו מזהי Accounts API לבדוק ומאיפה כל אחד מגיע.שגיאה 40001 ב-TikTok: אין הרשאה לפעולהשגיאה 40001 ב-TikTok אומרת שלקריאה אין הרשאה לפעולה. כך בודקים את הרשאת TikTok Accounts באפליקציה ואת ה-scopes של האסימון.שגיאת TikTok 40100: בקשות נשלחו תכופות מדישגיאת TikTok 40100 פירושה שמגבלת קצב הגבילה את הבקשה. איך מזהים אותה בתגובת HTTP 200, כמה זמן לעצור וכיצד להישאר מתחת למגבלה.שגיאת TikTok 40104: אסימון גישה ריקשגיאה 40104 ב-TikTok פירושה שהבקשה הגיעה ל-API ללא אסימון גישה. מוסבר איפה האסימון נדרש ואיך הוא נעלם.שגיאה 40110 של TikTok: קוד הרשאה לא תקיןשגיאה 40110 של TikTok פירושה שקוד ההרשאה בוטל, כבר נוצל או שפג תוקפו. קודי Accounts API תקפים 10 דקות ונוצלים פעם אחת. כך מקבלים קוד חדש.הגבלות כיתוב של TikTok דרך ה-API: אורך, האשטגים ותיוגיםכמה ארוך יכול להיות כיתוב TikTok דרך ה-API ל-Business, איך פועלים האשטגים ותיוגים, מתי מופיעות שורות חדשות, ומגבלות פוסטי תמונה.

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

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

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

נבדק ב-