שגיאות Instagram API: מה משמעות קודי השגיאה הנפוצים
השגיאות הנפוצות ביותר ב-Instagram API הן 190 עבור אסימון שפג או אינו תקף, 4, 17 ו-80002 עבור מגבלות קצב, 9004 עבור מדיה ש-Meta לא יכולה לשלוף, 9007 עבור סרטון שעדיין בעיבוד, 9 עבור מכסת הפרסום היומית, ו-10 עם subcode 2534022 עבור הודעה פרטית מחוץ לחלון ההודעות. כל שגיאה מגיעה כ-JSON עם code, לעיתים עם subcode שמציין את המקרה המדויק, והודעה.
easyCoexistence מטפל בצד החיבור של השגיאות האלה: הוא מחדש את הגישה ל-Instagram לפני שהיא פגה, בודק את החשבון כל 6 שעות ושולח לכם אימייל כשצריך להתחבר מחדש.
קוד השגיאה של Graph API לאסימון גישה שפג תוקפו, בוטל או אינו תקף בדרך אחרת.
קוד השגיאה למגבלת הקצב של Business Use Case של Instagram.
Subcode תחת קוד 9 עבור חשבון שהגיע למכסת הפרסום היומית ב-API.
Subcode תחת קוד 9004 עבור מדיה ש-Meta לא הצליחה לשלוף מהכתובת שניתנה.
Subcode תחת קוד 200 כאשר החשבון כיבה את הגישה להודעות שלו ב-Instagram.
איך קוראים שגיאה של Instagram API?
כל שגיאה היא אובייקט JSON תחת error. code הוא הקטגוריה הרחבה, error_subcode מציין את המקרה הספציפי ובדרך כלל הוא השימושי מביניהם, ושדה message מתאר את השגיאה. שגיאות רבות כוללות גם את השדה error_user_title, את השדה error_user_msg, שמכיל טקסט המיועד למשתמש, וגם את השדה is_transient. fbtrace_id מזהה את הבקשה עבור תמיכת Meta ופג תוקפו תוך זמן קצר, לכן רשמו אותו ביומן ברגע שהשגיאה מתרחשת.
מה משמעות שגיאות הגישה וההרשאות?
שגיאות על מי רשאי לעשות מה, עם התיקון לכל אחת:
- 190: אסימון הגישה שפג, בוטל או אינו תקף בדרך אחרת. subcode 463 פירושו שפג תוקף, 467 שאינו תקף ו-460 שינוי סיסמה. אסימון חדש מתקן זאת, ובחשבון מחובר פירוש הדבר חיבור מחדש.
- 10: הרשאה נדחתה. הרשאה מעולם לא ניתנה או הוסרה מאז.
- 200 עד 299: הרשאה ספציפית חסרה, למשל 200 עם subcode 2534041 כאשר החשבון כיבה את הגישה להודעות שלו.
- 25, subcode 2207050: החשבון מוגבל, לא פעיל או נעצר לבדיקת אבטחה. הבעלים צריך להתחבר לאפליקציית Instagram ולהשלים את מה שהיא מבקשת.
מה משמעות שגיאות מגבלת קצב?
הגבלה של קריאות, וכולן זמניות:
- 4: יותר מדי קריאות מהאפליקציה. המתינו ונסו שוב, או הקטינו את נפח הבקשות.
- 17: יותר מדי קריאות למשתמש. אותו פתרון חל.
- 80002: מגבלת Business Use Case של Instagram, שמחושבת לכל אפליקציה וחשבון לפי מספר החשיפות של החשבון: 4,800 קריאות לכל חשיפה ב-24 שעות.
- 613, subcode 2534040: יותר מדי קריאות הודעות. עצרו ונסו שוב מאוחר יותר.
מה משמעות שגיאות פרסום שקשורות למדיה?
שגיאות על הקובץ ועל המקום שבו הוא מאוחסן. רק הפסקת הזמן הקצוב כדאי לנסות שוב כמו שהיא:
- 9004, subcode 2207052: Meta לא הצליחה לשלוף את המדיה מהכתובת. ודאו שהכתובת תקפה וציבורית.
- -2, subcode 2207003: ההורדה ארכה יותר מדי. שווה לנסות שוב.
- 36000, subcode 2207004: התמונה גדולה מ-8 MB.
- 36001, subcode 2207005: פורמט התמונה אינו נתמך. השתמשו ב-JPEG.
- 36003, subcode 2207009: יחס הגובה-רוחב נמצא מחוץ לטווח שבין 4:5 ל-1.91:1.
- 352, subcode 2207026: פורמט הווידאו אינו נתמך. השתמשו ב-MOV או ב-MP4.
מה משמעות שגיאות פרסום של תזמון ומגבלות?
שגיאות על מתי וכמה, ורובן נפתרות בהמתנה או בהתחלה מחדש:
- 9007, subcode 2207027: המדיה עדיין לא מוכנה. המתינו עד שהערך
status_codeשל הקונטיינר יהיה FINISHED. - 24, subcode 2207008: הקונטיינר לא קיים או פג תוקפו. נסו שוב פעם או פעמיים בתוך 30 שניות עד 2 דקות, ואז צרו קונטיינר חדש.
- -2, subcode 2207020: תוקף המדיה פג. צרו קונטיינר חדש.
- 9, subcode 2207042: החשבון הגיע למגבלת הפרסום היומית. נסו שוב למחרת.
- 100, subcode 2207028: קרוסלה צריכה להכיל בין 2 ל-10 פריטים.
- 36004, subcode 2207010: הכיתוב ארוך מדי. המגבלות של Meta הן 2,200 תווים ו-20 תיוגי @, והתיעוד שלה מונה 30 האשטאגים, אף ש-Instagram מתיר 5 בפוסט.
- 4, subcode 2207051: Instagram הגביל את הפעולה כחשד לספאם.
מה משמעות שגיאות הודעות?
שגיאות מהודעות ישירות ומתשובות פרטיות לתגובות:
- 10, subcode 2534022: ההודעה נשלחה מחוץ לחלון המותר. המתינו עד שהאדם יכתוב שוב.
- 100, subcode 2534014: אין משתמש Instagram תואם. השתמשו במזהה ה-Instagram-scoped שמגיע מהוובהוק (Webhook), ולא במזהה משתמש Instagram.
- 100, subcode 2534025: לתגובה הזו אי אפשר לשלוח תשובה פרטית.
- 100, subcode 2534037: אפליקציה אחרת, כולל Business AI של Meta, שולטת בשיחה.
- 551, subcode 1545041: האדם אינו זמין כרגע.
מה משמעות שגיאות תובנות?
בקשות תובנות נכשלות בשלוש דרכים מתועדות:
- 10, אין מספיק צופים כדי שהמדיה תציג תובנות: מדד סטורי מתחת ל-5.
- מדד שפרש, כמו impressions מאז 21 באפריל 2025, מחזיר שגיאה. בקשו במקומו views.
- שגיאה לא ידועה כאשר אחד מכמה מדדים מבוקשים אינו תומך בפילוח שנדרש.
אילו שגיאות כדאי לנסות שוב?
רק השגיאות הזמניות: קודים 1 ו-2, שגיאות השרת של Instagram 2207001 ו-2207032, תם הזמן של ההורדה 2207003, השגיאה הקצרה 2207008, ומגבלות קצב אחרי שההמתנה הסתיימה. כל השאר מחזיר את אותה תשובה עד ששונה משהו, בין אם הקובץ, הכתובת, ההרשאה, מצב החשבון או חלון הזמן של האדם, וניסיון חוזר באלה רק מבזבז את מגבלת הקצב.
טעויות נפוצות
- ניסיון חוזר על שגיאת פורמט או גודל. 2207004, 2207005, 2207009 ו-2207026 נכשלים באותה דרך עד ששונה המדיה.
- להתייחס ל-9007 ככישלון. הסרטון עדיין בעיבוד, לכן פרסמו כשהקונטיינר מציג FINISHED.
- קריאה רק של הקוד. קודים כמו 10 ו-100 מכסים מקרים רבים, ורק ה-subcode מציין איזה מקרה זה.
- השמטת fbtrace_id מהיומנים. תמיכת Meta מבקשת אותו, והוא פג תוקף זמן קצר אחרי השגיאה.
Claude, ChatGPT או הקוד שלכם קוראים אז ל-API הרשמי של Meta עם אסימון שנשמר עדכני. US$ 9 עד US$ 0.75 לחיבור בחודש, והמחיר יורד ככל שמוסיפים חיבורים, עם תקופת ניסיון של 3 ימים בחינם.
שאלות נפוצות
מה משמעות שגיאה 190 ב-Instagram?
אסימון הגישה פג, בוטל או אינו תקף בדרך אחרת, למשל לאחר שינוי סיסמה. אסימון חדש מתקן זאת, ובחשבון מחובר פירוש הדבר חיבור מחדש.
למה פרסום נכשל עם 9004?
Meta לא הצליחה לשלוף את המדיה מהכתובת שניתנה, subcode 2207052. בדקו שהקישור תקף וציבורי, בלי התחברות לפניו, ברגע שהפוסט מתפרסם.
מה זו שגיאה 9007?
הסרטון בקונטיינר עדיין בעיבוד, subcode 2207027. בדקו את הערך status_code של הקונטיינר ופרסמו כשהוא מציג FINISHED.
מה זה fbtrace_id בשגיאה של Instagram API?
מזהה של הבקשה שנכשלה, שתמיכת Meta מבקשת כשמדווחים על בעיה. הוא פג תוקף זמן קצר לאחר השגיאה, לכן רשמו אותו ביומן באותו רגע.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-