Instagram API באפליקציות מובייל: Graph ו-Basic Display
אנו משלבים את Instagram API באפליקציות מובייל. לקוחות часто מבקשים "להוסיף אינסטגרם" מבלי לפרט. זו טעות: בחירת API שגויה גוזלת שבועות של פיתוח. Instagram Graph API (לחשבונות עסקיים) מאפשר פרסום תוכן, ניהול תגובות וצפייה בנתונים סטטיסטיים. Instagram Basic Display API (לחשבונות אישיים) קורא רק מדיה של משתמשים. בואו נבחן את ההבדלים המעשיים.
בחירת ה-API הנכון חוסכת עד 40% מזמן האינטגרציה ומפחיתה את הסיכון לדחיית App Review. בהתבסס על 20+ פרויקטים, אנו מבטיחים פתרון עובד.
איזה Instagram API לבחור לפרסום?
ראשית, הבהירו: האם אתם צריכים לפרסם לאינסטגרם או רק להציג תמונות? לקריאה, Basic Display עובד. לפרסום, רק Graph API מתאים, והוא דורש חשבון עסקי המחובר לעמוד פייסבוק. הניסיון שלנו: מעל 5 שנים בעבודה עם Instagram API, 20+ פרויקטים — אנו מבטיחים בחירה נכונה.
| תכונה | Basic Display API | Graph API |
|---|---|---|
| קריאת מדיה של משתמש | כן | כן |
| פרסום תמונות וסרטונים | לא | כן |
| ניהול תגובות | לא | כן |
| קבלת נתונים סטטיסטיים | לא | כן |
| תמיכה בחשבונות אישיים | כן | לא |
| סוג חשבון נדרש | אישי | עסקי (Instagram Creator או Business) |
השוואה זו מראה: Graph API עדיף אם אתם צריכים שליטה על תוכן. Basic Display מיועד רק ל"התחברות עם אינסטגרם." התיעוד הרשמי של אינסטגרם ממליץ על Graph API לכל אינטראקציה מעבר לקריאה.
Instagram Basic Display API: אימות וקריאת מדיה
מתאים לתרחישים של "התחברות עם אינסטגרם והצגת התמונות שלך." אימות OAuth:
https://api.instagram.com/oauth/authorize
&client_id=YOUR_APP_ID
&redirect_uri=yourapp://oauth
&scope=user_profile,user_media
&response_type=codeקבלת מדיה:
GET https://graph.instagram.com/me/media
&fields=id,caption,media_type,media_url,thumbnail_url,timestamp
&access_token=...דפדוף באמצעות https://api.instagram.com/oauth/authorize &client_id=YOUR_APP_ID &redirect_uri=yourapp://oauth &scope=user_profile,user_media &response_type=code משדה GET https://graph.instagram.com/me/media &fields=id,caption,media_type,media_url,thumbnail_url,timestamp &access_token=... . הטוקן חי 60 יום, ומתחדש עם cursor. מגבלה: לא ניתן לפרסם, להגיב או לקבל עוקבים. רק קריאה של התוכן שלך.
Instagram Graph API: פרסום היום
פרסום דורש חשבון אינסטגרם עסקי המחובר לעמוד פייסבוק, ואפליקציה ב-Facebook Developer Console עם הרשאת paging.cursors. ה-API יציב כבר שנים.
איך לקבל Access Token באפליקציית מובייל?
Instagram Graph API אינו תומך באימות ישיר ללא Facebook SDK. הזרימה הסטנדרטית:
- אימות באמצעות Facebook Login SDK (
refresh_access_tokenב-iOS/Android). - בקשת הרשאות
instagram_content_publish,FBSDKLoginKit. - קבלת Facebook User Access Token.
- המרה לטוקן ארוך טווח בשרת.
Facebook SDK ב-iOS מוסיף 6 MB לבינארי. חלופה ללא SDK היא OAuth דרך instagram_content_publish / Custom Tab עם טיפול ידני בטוקן. אנו משתמשים ב-SDK ב-80% מהפרויקטים — מהיר ואמין יותר. מידע נוסף על OAuth ניתן למצוא בויקיפדיה.
פרסום תמונות: תהליך דו-שלבי
- יצירת מיכל מדיה:
POST https://graph.facebook.com/v19.0/{ig-user-id}/media
&image_url=https://yourserver.com/photo.jpg
&caption=Подпись к посту #тег
&access_token=...תגובה: instagram_basic — מזהה מיכל.
- פרסום המיכל:
POST https://graph.facebook.com/v19.0/{ig-user-id}/media_publish
&creation_id=17889615814797203
&access_token=...חשוב: התמונה חייבת להיות נגישה דרך כתובת HTTPS ציבורית. אינסטגרם מורידה אותה לשרתים שלה. ארכיטקטורה: הלקוח מעלה תמונה ל-S3 → מקבל כתובת ציבורית → שולח לשרת → השרת קורא ל-Graph API. אנו מבטיחים טיפול נכון בשגיאות ולוגיקת ניסיונות חוזרים.
פרסום סרטונים (Reels) וקרוסלות
אותה זרימה דו-שלבית אך עם ASWebAuthenticationSession ו-POST https://graph.facebook.com/v19.0/{ig-user-id}/media &image_url=https://yourserver.com/photo.jpg &caption=Подпись к посту #тег &access_token=... . לאחר יצירת המיכל, המתינו לעיבוד הסרטון — בדקו סטטוס דרך { "id": "17889615814797203" }. לקרוסלה: שלושה שלבים — צרו מיכלי פריטים לכל תמונה, ואז מיכל קרוסלה עם POST https://graph.facebook.com/v19.0/{ig-user-id}/media_publish &creation_id=17889615814797203 &access_token=... , ואז פרסמו.
| פרמטר | ערך |
|---|---|
| מספר פריטים מקסימלי בקרוסלה | 10 |
| דרישות מדיה | 1080×1080, JPG/PNG |
| זמן עיבוד סרטון | עד 10 שניות |
מגבלות ומכסות
- 25 פרסומים ביום לחשבון.
- 200 בקשות בשעה לכל access token.
-
media_type=REELSמ-Basic Display API חי רק כמה שעות — אל תאחסנו במטמון. - Facebook App Review עבור
video_urlלוקח 5–10 ימי עסקים.
Webhooks לאירועים
Graph API תומך ב-webhooks: תגובה חדשה, אזכור חדש, שינוי סטטוס פרסום. הגדרה דרך Facebook Developer Console: אימות טוקן וכתובת callback. דורש נקודת קצה HTTPS. בחלק זה, אנו מחברים התראות בזמן אמת — השרת שלך מקבל נתונים ללא סקירה חוזרת.
שלבי עבודה
- ניתוח: קביעת ה-APIs הנדרשים, הרשאות, ארכיטקטורה.
- רישום אפליקציית Facebook + הגדרת מוצר אינסטגרם.
- יישום זרימת OAuth בצד הלקוח והשרת.
- פיתוח פונקציונליות ליבה (קריאה, פרסום, webhooks).
- בדיקות: אינטגרציה, עומס.
- מעבר App Review.
- פריסה ותיעוד.
לוחות זמנים
אינטגרציה בסיסית (אימות + קריאת מדיה) מתחילה מ-3 ימים. עם פרסום ו-webhooks, מ-6 ימים, בתוספת זמן App Review. לוחות זמנים ועלות מדויקים מחושבים באופן אישי. צרו קשר לייעוץ — נעריך תוך יום עסקים אחד.
טעויות אינטגרציה נפוצות
- שכחת רענון הטוקן — שגיאת 401 אחרי 60 יום.
- אי ציון ה-OAuth scope הנכון — קבלת 403.
- אחסון
GET /{container-id}?fields=status_codeבמטמון יותר מכמה שעות. - כישלון ב-App Review — חוסר בצילומי מסך של הפונקציונליות.
צרו קשר לייעוץ. קבלו הצעה מותאמת אישית לפרויקט שלכם.