שגיאת 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.
קוד ההחזרה של TikTok לשגיאת פרמטר, עם הפרטים בתוך הודעת התגובה.
הסטטוס של התגובה לדוגמה של TikTok ל-40002: שדה הקוד, ולא הסטטוס, מראה את הכשל.
אורך הכיתוב של סרטון, בתווים שנספרים ב-UTF-16, שאפשר להעביר דרך Accounts API, כולל עד 30 תיוגים.
מספר התגובות בעמוד ש-/business/comment/list/ מקבל ב-max_count, וברירת המחדל היא 20.
כמה רחוק אחורה יכול להגיע 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 מבקש אותו בדיווחי תקלות.
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.
כשעדיין מוחזר 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, עם סיבה שמציינת איזו בדיקה נכשלה.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-