Instagram, aylık aktif kullanıcı sayısı 2 milyarın üzerinde olan dünyanın en büyük görsel sosyal ağlarından biridir. Bu dev ekosistemin arkasında, içerik yönetim araçlarından analiz panellerine kadar her şeyi destekleyen gelişmiş bir dizi API bulunur. API, geliştiriciler, işletmeler ve programlı olarak Instagram verilerine ve işlevselliğine erişim ihtiyacı duyan yaratıcılar için birincil arayüzdür.
Basic Display API’nin kullanımının kaldırılması tamamlandıktan sonra tüm Instagram entegrasyonları artık ya Instagram Graph API’yi ya da Instagram Messaging API’yi kullanmalıdır. Bu kılavuz, kimlik doğrulamadan optimizasyon stratejilerine kadar tüm ekosistemi adım adım gezerek verimli ve ölçeklenebilir uygulamalar inşa etmenize yardımcı olur.
- Instagram’ın hız sınırları ve İş Kullanım Durumu mantığı nasıl çalışır
- Mevcut uç noktalar ve her birinin hangi işlemleri desteklediği
- Her iki işletme giriş yöntemi için adım adım kimlik doğrulama kurulumu
- Yaygın kullanım durumları için gerçek dünya uygulama kalıpları
- Oran sınırlarını maksimize etmek için optimizasyon teknikleri
Kullanım senaryosunu anlamak ilk adımdır. Instagram Graph API’nin yaygın uygulamalarından başlayarak kilit kavramları keşfedelim.
Instagram Graph API Nerede Uygulanır?
Instagram Graph API, farklı kullanım durumları ve gereksinimleri olan birden çok geliştirici topluluğuna hizmet eder.
Ürün Geliştiricileri
Instagram içeriğini kullanan SaaS çözümleri geliştirirken, Instagram Graph API temelinizdir. Sosyal medya yönetim platformları, influencer pazarlama araçları, içerik küratörlük hizmetleri veya analiz panelleri oluşturuyor olun; API, Instagram’ın veri altyapısına yapılandırılmış erişim sağlar.
Sosyal Medya Ajansları ve Danışmanları
Birden çok müşteri hesabını yöneten ajanslar, performans verilerini çekmek, içerik planlamak, kampanya metriklerini izlemek ve tek tek her müşterinin Instagram hesabına giriş yapmadan otomatik raporlar oluşturmak için Graph API’yi kullanır.
İçerik Üreticileri & Stüdyolar
Profesyonel yaratıcılar ve içerik stüdyoları, toplu yüklemeleri otomatikleştirmek, videolar arasındaki meta verileri yönetmek, zaman içindeki performans eğilimlerini izlemek, ekip üyeleriyle koordine olmak ve içerik stratejisi için içgörüler elde etmek amacıyla Graph API’yi entegre eder. API, içerik üreticilerinin içerik oluşturmaya odaklanmasına olanak tanır ve platform mekaniğini düşünmeden çalışmasını sağlar.
E-Ticaret İşletmeleri
Instagram Mağazaları olan işletmeler, ürün etiketlerini yönetmek, satın alınabilir gönderi performansını izlemek, katalog verilerini senkronize etmek ve dönüşüm metriklerini izlemek için Graph API’yi kullanır. API, Instagram’ın yerleşik ticaret özellikleri ile harici envanter yönetim sistemleri arasındaki köprüyü kurar.
Araştırma ve Analitik Platformları
Araştırmacılar, pazar analistleri ve veri bilimciler, geniş ölçekli çalışmalar için Instagram Graph API’yi kullanıyor. Trendleri analiz edebilir, hedef kitle demografisini inceleyebilir, etkileşim kalıplarını takip edebilir ve binlerce hesap üzerinden içerik analizi gerçekleştirebilirsiniz — kapsamlı manuel toplama gerekmez.
Instagram Graph API Kimlik Doğrulamasını Anlamak
Herhangi bir API isteği yapmadan önce kimlik doğrulamanız gerekir. Instagram Graph API, farklı senaryolar ve kullanım durumları için tasarlanmış iki kimlik doğrulama yaklaşımını destekler.
🎯 Yöntem 1: İş Hesabı Girişi (Instagram Girişi ile API)
The İşletme Girişi yaklaşımı OAuth 2.0 kullanarak kullanıcıları doğrudan Instagram üzerinden doğrular. Bu yöntem, belirli bir Instagram İşletme veya İçerik Üreten hesabının izinlerini temsil eden kullanıcı erişim belirteçleri üretir.
Ne Zaman Kullanılır
- Kullanıcılar Instagram üzerinden doğrudan kimlik doğrulaması yaptıkları uygulamalar geliştirme
- Tek bir belirli Instagram hesabından veri erişimi
- Facebook altyapısının en az düzeyde dahil olduğu senaryolar
- Mobil uygulamalar veya tüketiciye yönelik uygulamalar
Nasıl Çalışır
- Kullanıcı, uygulamanızda oturum açar
- Uygulamanız Instagram’ın yetkilendirme uç noktasına yönlendirilir
- Kullanıcı doğrular ve izinleri verir
- Instagram, bir yetkilendirme kodu döndürür
- Uygulamanız kodu kısa ömürlü bir erişim belirtecine değiştirir
- Kısa ömürlü token’ı uzun ömürlü token ile değiştirin (60 günlük geçerlilik)
Gerekli izinler:
🔗 Yöntem 2: Facebook Girişi ile İşletme (Facebook Girişi ile Instagram API)
Facebook Giriş yöntemi, Facebook Sayfalarına bağlı Instagram hesaplarını kullanır. Bu yöntem, kurumsal uygulamalar ve Facebook’ın ekosistemiyle entegrasyonlar için daha yaygındır.
Ne Zaman Kullanılır
- Birden çok müşteri hesabını yöneten platform çözümleri geliştirme
- Facebook Sayfaları ile entegrasyon (çoğunlukla Instagram hesaplarını yöneten sayfalar)
- Kurumsal Uygulamalar ile merkezi hesap yönetimi
- Instagram hesaplarının Business Manager üzerinden yönetildiği sistemler
Nasıl Çalışır
- Facebook Uygulaması Oluşturun: Facebook Geliştiriciler
- Gerekli izinleri ekleyin:
pages_show_listbusiness_managementinstagram_basic - Kullanıcı, Instagram İş Hesabını bir Facebook Sayfasına bağlar
- Sayfadan bağlı Instagram hesabı kimliğini alın
- Bu ID’yi kullanarak erişim belirteçleri oluşturun
Gereksinimler
- Instagram hesabı İş Hesabı veya Creator hesabı olmalıdır
- Instagram hesabı bir Facebook Sayfasına bağlı olmalıdır
- Kullanıcının bağlı Facebook Sayfası üzerinde yönetici erişimine sahip olması gerekir.
📊 Karşılaştırma: Hangi Kimlik Doğrulama Yöntemi?
Seçiminize yardımcı olması için, bu iki yaklaşımın kilit boyutlarda nasıl farklılaştığını gösteren ayrıntılı bir karşılaştırma aşağıdadır:
| Özellik | İş Girişi | Facebook Girişi |
|---|---|---|
| Kurulum Karmaşıklığı | Orta | Daha Yüksek |
| En İyisi İçin | Tek hesap, kullanıcı odaklı uygulamalar | Çoklu hesaplar, kurumsal araçlar |
| Token Kaynağı | Doğrudan Instagram OAuth | Facebook Sayfası bağlantısı |
| Gerekli İzinler | Instagram’a özel 3–4 kapsam | 3+ Facebook ve Instagram kapsamları |
| Hesap Bağlantısı | Doğrudan | Facebook Sayfası Üzerinden |
| Token Süresi | 60 gün (uzun ömürlü) | 60 gün (uzun ömürlü) |
Tek hesapla basitlik için İşletme Girişi’ni seçin; birden çok müşteri entegrasyonunu yönetiyorsanız Facebook Girişi’ni kullanın.
Instagram Hız Sınırını Anlama ve İş Kullanım Mantığı
Instagram Graph API, Standart hız sınırından önemli ölçüde farklı olan İş Amaçlı Kullanım (BUC) hız sınırlandırma sistemi kullanır. Bu sistemi anlamak, uygulamanızın sınırları beklenmedik şekilde aşmamasını sağlar.
📄 Temel Hız Sınırı Yapısı
Instagram Graph API aşağıdaki hız sınırlarını uygular:
Kullanıcı başına saatlik 200 istek
Bu, erişim sağladığınız her benzersiz Instagram hesabı için uygulamanızın herhangi bir saatlik pencerede en fazla 200 API çağrısı yapabileceği anlamına gelir. 10 Instagram hesabınız bağlıysa toplam kapasiteniz saatte 2.000 çağrıya yükselir (200 × 10).
Ana Etkiler
- Her Instagram hesabı için izole bir hız limiti havuzu vardır. Aynı uygulamadaki birden çok API anahtarı hesaplar arasında limit paylaşmaz.
- Saatlik sınır saatte bir sıfırlanır, günlük değil. Ancak saatlik pencere kayar—her API çağrısı pencereyi bir saat ileri götürür.
- Tüm istekler, başarılsın ya da başarısız olsun, limite sayılır. Geçersiz bir istek bile hız sınırınızı tüketir
- Sayfalama ayrı istekler olarak sayılır. Yorumların 5 sayfasını almak, saatlik 200 isteğinizden 5’ini kullanır
- İstek sınırı, doğrulanmış kullanıcıya değil uygulamaya bağlıdır. Uygulamanızı kullanan tüm kullanıcılar belirli bir Instagram hesabı için aynı kota havuzunu paylaşır.
İşletme kullanımında oran sınırı nasıl çalışır
Standart hız sınırlamasının aksine, Instagram’ın BUC sistemi limitleri hesabın özellikleri ve etkileşim düzeyine göre belirler:
Formül: Instagram kullanıcısı başına saatlik 200 istek
Temel kota saatte 200 istekle sabittir. Ancak Meta, bu kotanın şu durumlara göre ayarlanabileceğini belirtir:
- Uygulama Davranışı ve Uyum Geçmişi
- Hesap aktivite desenleri
- Yapılan işlemlerin türü
- Erişilen veri hacmi
Bu sistem, kötüye kullanımı önlerken meşru uygulamaların ölçekli şekilde çalışmasına olanak tanır.
İstek Sınırı Başlıkları ve İzleme
Çoğu API yanıtı şu başlığı içerir:
X-Business-Use-Case-Usage: { "ig_api_usage": [ { "acc_id_util_pct": 50, "reset_time_duration": 3600 } ] } Hız sınırı tüketiminizi izlemek için bu başlıkları çözümleyin:
Uygulama ipucu: acc_id_util_pct 80-90%’ye ulaştığında üssel geri almayı uygulayın ve kalan istekleri bir sonraki saate kuyruğa alın. %100’e asla ulaşmasına izin vermeyin.
Saatlik 200 İstekle Neler Yapabilirsiniz?
Kota sınırlı görünebilir, ancak tamamen API kullanımınızı ne kadar verimli tasarladığınıza bağlıdır. İşte gerçekçi senaryolar:
Senaryo 1: Çok Hesaplı Gösterge Paneli
- 5 hesabın temel bilgilerini alın: 5 istek
- Hesap başına en son 20 gönderi: 5 istek
- Gönderi Başına Etkileşim Metrikleri: 100 istek (20 gönderi × 5 hesap)
- Saatlik kullanım: ~110 istek | Kapasite: Gösterge panelini saatte 1–2 kez yenileyebilir
Senaryo 2: Gerçek Zamanlı Yorum İzleme
- Yeni yorumları her 5 dakikada bir kontrol edin: Saatte 12 istek
- Kontrol başına 50 yorum alın: 12 istek
- Yorum yazarı bilgilerini alın: 24 istek
- Saatlik kullanım: ~48 istekler | Kapasite: İzleme sistemi ek yükle gün boyu çalışır
Senaryo 3: Hafif İçerik Akışı Görüntüleme
- Bir hesaptan 10 gönderi alın: 1 istek
- Başlıklar ve etkileşimler: 1 istek (yanıt içinde yer alır)
- Web Sitesinde Göster: Ek İstek Yok
- Saatlik kullanım: ~sayfa görüntüleme başına yaklaşık 2 istek | Kapasite: Saatlik binlerce sayfa görüntülemeyi destekler
🔌 Instagram Graph API Uç Noktaları ve Yetkinlikler
Instagram Graph API, her biri belirli amaçlara hizmet eden birçok uç nokta kümesi sağlar. Hangi işlemleri hangi uç noktalar destekliyor, uygulama tasarımı için kritik öneme sahiptir.
Çekirdek Uç Noktası Kategorileri
Medya Yönetimi
Instagram İşletme ve İçerik Üreten hesaplardan medya içeriğini alın, analiz edin ve yayınlayın.
Desteklenen işlemler:
Yorum Yönetimi
Medya üzerindeki yorumları alın, yanıtlayın ve yönetin.
Desteklenen işlemler:
İçgörüler ve Analitik
Medya, hesaplar ve hedef kitle davranışları hakkında ayrıntılı performans metriklerine erişin.
Desteklenen işlemler:
Hashtag Arama
Belirli hashtaglerle etiketlenmiş herkese açık Instagram medyalarını bulun.
Desteklenen işlemler:
Hız sınırı uyarısı: Instagram hesabı başına haftada 30 adet benzersiz hashtag araması yapabilirsiniz. 7 gün sonra, daha önce aranan hashtag’ler için sınır sıfırlanır.
İşletme Keşfi
Diğer Instagram İş Hesapları ve Creator hesapları hakkında meta verileri ve istatistikleri alın.
Desteklenen işlemler:
GET /{ig-user-id}?fields=business_discovery.username({target_username}){id,followers_count,media_count,biography,website,username} — İşletme hesabı verilerini keşfedin
Dönen Değerler: takipçi sayısı, medya sayısı, biyografi, web sitesi, doğrulanmış durum
Bahsetmeler ve Etiketler
Hesabınızın diğer kullanıcılar tarafından bahsedildiği medyayı bulun.
Desteklenen işlemler:
Dönen Veriler: yorum metni, yazar bilgisi, zaman damgası
Desteklenen Kaynak Tipleri ve İşlemler
Tüm kaynaklar aynı işlemleri desteklemez. Her Instagram kaynağı türüyle yapabileceklerinizin tam bir dökümü aşağıdadır:
| Kaynak | Liste | Oluştur | Güncelleme | Sil | Amaç |
|---|---|---|---|---|---|
| IG Kullanıcısı | ✓ | ✗ | ✗ | ✗ | Hesap profili ve temel bilgiler |
| IG Medya | ✓ | ✓ | ✗ | ✗ | Fotoğraflar, videolar, Reels, karusel paylaşımları |
| IG Yorumu | ✓ | ✓ | ✗ | ✓ | Medya Üzerindeki Yorumlar (Moderasyon) |
| IG Insight | ✓ | ✗ | ✗ | ✗ | Performans metrikleri (yalnızca okunabilir) |
| IG Etiketi | ✓ | ✗ | ✗ | ✗ | Hashtag arama ve keşif |
| IG Hikayesi | ✓ | ✗ | ✗ | ✗ | Hikaye verisi (sınırlı erişim) |
| Instagram Bahsi | ✓ | ✗ | ✗ | ✗ | @mentions ve etiketler (salt okunur) |
Entegrasyonunuzu planlarken bu matrisi referans olarak kullanın; API’nin desteklemediği işlemlere girişinizi önler.
Instagram Graph API Kimlik Doğrulamasını Kurma: Adım Adım
İki kimlik doğrulama akışını adım adım birlikte inceleyelim, böylece çalışan bir token elde edin ve API çağrılarına hemen başlayın.
🔑 İş Girişiyle Başlayın
Adım 1: Meta Geliştirici Uygulaması Oluşturun
Facebook Geliştiriciler sayfasına gidin ve https://developers.facebook.com üzerinden yeni bir uygulama oluşturun. İstenildiğinde uygulama türü olarak “İşletme”yi seçin.
Adım 2: Instagram Ürünü Ekle
- Uygulama panelinizde “Ürünler Ekle” ye tıklayın
- Instagram Graph API’yi bulun ve ‘Kur’ düğmesine tıklayın
- Bu, Instagram’ı uygulamanızda mevcut bir ürün olarak ekler.
Adım 3: Erişim Belirteci Oluştur
Bir erişim belirteci oluşturmak için Graph API Explorer veya SDK’yı kullanın:
GET /oauth/authorize ?client_id={YOUR_APP_ID} &redirect_uri={YOUR_REDIRECT_URI} &response_type=code &scope=instagram_basic,instagram_graph_user_profile Kullanıcı yetkilendirmesinden sonra kodu token ile değiştirin:
POST /oauth/access_token ?client_id={YOUR_APP_ID} &client_secret={YOUR_APP_SECRET} &grant_type=authorization_code &code={AUTHORIZATION_CODE} &redirect_uri={YOUR_REDIRECT_URI}
Adım 4: Uzun Ömürlü Jeton’a Geçiş
Aldığınız token kısa ömürlüdür (genelde 1 saat). Bunu uzun ömürlü bir token ile değiştirin (60 gün):
GET /access_token ?grant_type=ig_exchange_token &client_secret={YOUR_APP_SECRET} &access_token={SHORT_LIVED_TOKEN}
İşletme İçin Facebook Girişine Başlarken
Adım 1: Instagram’ı Facebook Sayfasına Bağla
- Instagram İş hesabınıza gidin
- Profilinizi açın → Profilinizi Düzenleyin
- “Profesyonel Gösterge Paneli” altında, “Sayfa”yı bulun ve “Facebook Sayfası Bağla veya Oluştur”u tıklayın.
- Facebook Sayfanızı seçin veya oluşturun
Adım 2: Meta Geliştirici Uygulamasını Oluşturun
İş Girişi ile aynı uygulama oluşturma sürecini izleyin, ancak Facebook Girişi için özel olarak yapılandırın.
Adım 3: İzinleri Yapılandır
Uygulama yapılandırmanızda şu izinleri talep edin:
pages_show_list — Facebook Sayfalarınızın Listesine Erişin
Adım 4: Instagram Hesap Kimliğini Elde Et
GET /{FACEBOOK_PAGE_ID} ?fields=instagram_business_account &access_token={PAGE_ACCESS_TOKEN} Bu, API çağrıları için kullanacağınız bağlı Instagram Hesap Kimliği’ni döndürür.
Adım 5: Instagram Jetonları Oluşturun
Instagram Hesap Kimliğini edindiğinizde, bu kimliği kullanarak Instagram uç noktalarına erişin ve hesap bazlı erişim belirteçleri oluşturun.
🔄 Token Yaşam Döngüsü ve Yenileme
Uzun ömürlü jetonlar kullanılmama halinde 60 gün sonra süresi doluyor. Ancak, verildiği andan itibaren 24 saat geçtikten sonra her an yenilenebilirler.
Jetonu Yenileyin:
GET /refresh_access_token ?grant_type=ig_refresh_token &access_token={LONG_LIVED_TOKEN} En İyi Uygulamalar:
- Jetonları güvenli saklayın (veritabanında şifreli, hiçbir zaman frontend kodunda)
- Token yenileme mantığını otomatik olarak her 50-55 günde bir yenileyin
- Tokenlar süresi yaklaşırken uyarılar ayarlayın
- Uygulamanızda tokenleri asla kod içinde saklamayın
Ortak Uygulama Kalıpları
Aşağıdakiler, Instagram Graph API ile yapacağınız en yaygın görevlerdir. Bu örüntüler, çoğu üretim entegrasyonunun temelini oluşturur.
💻 Medya İçgörülerini Alma
Son paylaşımlar için etkileşim verilerini alın:
GET /{ig-user-id}/media ?fields=id,caption,media_type,timestamp &access_token={LONG_LIVED_TOKEN} Döndürülen her medya kimliği için içgörüleri elde edin:
GET /{media-id}/insights ?metric=impressions,reach,engagement,saves &access_token={LONG_LIVED_TOKEN}
💬 Yorumları Yönetme
Bir gönderideki son yorumları alın:
GET /{media-id}/comments ?fields=id,text,username,timestamp,user &access_token={LONG_LIVED_TOKEN} Bir Yoruma Yanıt Verin:
POST /{media-id}/comments ?message={REPLY_MESSAGE} &access_token={LONG_LIVED_TOKEN} Uygunsuz yorumu gizle:
POST /{comment-id} ?hidden=true &access_token={LONG_LIVED_TOKEN}
📇 İçerik Yayımlama
İçerik yayınlama süreci ‘konteynerler’ kullanır. Öncelikle bir konteyner oluşturun, durumunu izleyin, ardından yayınlayın:
POST /{ig-user-id}/media ?image_url={IMAGE_URL} &caption={CAPTION} &access_token={LONG_LIVED_TOKEN} Konteyner durumunu kontrol edin:
GET /{container-id} ?fields=status_code &access_token={LONG_LIVED_TOKEN} Durum FINISHED olduğunda yayınla:
POST /{ig-user-id}/media_publish ?creation_id={CONTAINER_ID} &access_token={LONG_LIVED_TOKEN}
🔖 Hashtag ile Arama
Belirli bir hashtag ile etiketlenen gönderileri bulun:
GET /ig_hashtag_search ?user_id={ig-user-id} &hashtag={HASHTAG_NAME} &access_token={LONG_LIVED_TOKEN} Bu, bir hashtag düğüm kimliğini döndürür. Ardından paylaşımları alın:
GET /{hashtag-id}/recent_media ?fields=id,caption,media_type,timestamp &access_token={LONG_LIVED_TOKEN}
Optimizasyon Stratejileri: API Çağrılarını Azaltın ve Oran Sınırları İçinde Kalın
Hesap başına saatte yalnızca 200 istekle, optimizasyon opsiyonel değildir—ölçeklenebilirlik için şarttır.
1. Sadece Gereken Alanları Talep Edin
Varsayılan olarak, birçok uç nokta kapsamlı veri döndürür. İhtiyacınız olan tek veriyi talep etmek için fields parametresini kullanın:
Yerine:
GET /{media-id} Kullanım:
GET /{media-id}?fields=id,caption,timestamp,media_url Bu, yanıt boyutunu küçültür, gecikmeyi iyileştirir ve Meta’ya verileri kullanma konusunda düşünceli olduğunuzu gösterir.
2. Akıllı Önbelleğe Alma Uygulayın
Uygun TTL (time-to-live) ile API yanıtlarını önbelleğe alın:
- Statik içerik (altyazılar, gönderi URL’leri): 24 saat
- Etkileşim metrikleri (beğeniler, yorumlar): 1–6 saat
- Gerçek Zamanlı veri (canlı yorumlar): 5-30 saniye
Önbellek Avantajı: Önceden her yenilemede 50 API çağrısı gerektiren bir gösterge paneli, önbellekle 10 çağrıya düşebilir ve diğer işlemler için 40 çağrı açığa çıkarır.
3. Mümkün olduğunda Toplu İstekler
Bazı uç noktalar tek bir istekte birden çok ID’ye izin verir:
GET / ?ids={id1},{id2},{id3} &fields=id,caption,engagement &access_token={TOKEN} Bu, 3 medya nesnesini 1 API çağrısı ile getirir. API toplu çağrıları desteklediğinde her zaman toplu olarak çalışın.
4. Verimli Sayfalama
Instagram, cursor tabanlı sayfalama ile sayfalı sonuçlar döndürür. Sadece ihtiyacınız olan veriyi alın:
GET /{media-id}/comments ?limit=50 &after={PAGINATION_CURSOR} &access_token={TOKEN} İhtiyaçlarınıza uygun şekilde limit değerini ayarlayın (tipik olarak 50-100). Sadece son öğelere ihtiyacınız varsa tüm mevcut veriyi çekmeyin.
5. Gerçek Zamanlı Güncellemeler İçin Webhook’ları Kullanın
Yeni yorumlar veya bahsetmeler için API’yi sürekli sorgulamak yerine webhooks’a abone olun. Olaylar meydana geldiğinde Instagram bildirimleri uç noktanıza iletir. Bu, sürekli sorgulamadan yalnızca olay odaklı isteklerle API çağrılarını azaltır.
POST /app/webhooks
Desteklenen Etkinlikler:
- Yorumlar (Gönderilerdeki yeni yorumlar)
- Bahsedilmeler (@hesabınızın bahsedilmesi)
- Hikaye İçgörüleri (hikaye performans güncellemeleri)
- Mesajlar (doğrudan mesaj bildirimleri)
6. Tekrar Denemeler İçin Üssel Geri Çekmeyi Uygulayın
İstek sınırlarına ulaşıldığında (429 hatası), hemen yeniden denemeyin. Bunun yerine üssel geri bekleme ile bekleyin:
wait_time = initial_wait * (2 ^ attempt_number)
Deneme 1: 1 saniye bekle Deneme 2: 2 saniye bekle Deneme 3: 4 saniye bekle Deneme 4: 8 saniye bekle
Bu, API’ye aşırı istek yapılmasını önler ve kotanızın yeniden sıfırlanması için zaman tanır.
Instagram Basic Display API’nin Kullanımdan Kaldırılması ve Geçiş
Kullanımdan kaldırma tarihi geçmiş olsa da, pek çok geliştirici hâlâ geçiş yapacak eski entegrasyonlara sahip. Nelerin değiştiğini ve nedenini anlamak, geçişinizi sorunsuz planlamanıza yardımcı olur.
🔍 Ne Değişti?
Biliyor muydunuz? Meta, kişisel Instagram hesaplarına üçüncü taraf erişimini kısıtlamak amacıyla Basic Display API’yi kullanımdan kaldırdı; veri erişimini sıkılaştırdı ve iş hesaplarına tüketici uygulamalarına göre öncelik verdi.
4 Aralık 2024’te Instagram Basic Display API kullanımdan kaldırıldı. Bu API, daha önce basit bir OAuth akışıyla kişisel Instagram hesaplarına salt okunur erişim sağlıyordu. Bu tarihten sonra artık çalışmıyor.
Önemli Değişiklikler
- Kişisel Instagram hesapları artık üçüncü taraf API’ler üzerinden desteklenmiyor
- Sadece İş ve İçerik Oluşturucu hesaplar uygulamalara bağlanabilir
- Tüm entegrasyonlar Instagram Graph API’ye geçmelidir
- Basic Display API tokenları artık üretilmiyor ve işlev göstermiyor
Etki ve Geçiş Yolu
Kimin Etkilendiği:
- Web sitelerinde kişisel Instagram akışlarını gösteren uygulamalar
- Sosyal Medya Toplama Araçları
- Instagram içeriğini gösteren portföy hizmetleri
- Basic Display API’nin User Token Generator kullanan herhangi bir entegrasyon
Geçiş Adımları:
- Kişisel Instagram hesaplarını İşletme veya Creator hesaplarına dönüştürün
- Instagram hesabını Facebook Sayfası ile bağlayın
- Uygulamanızı Instagram Graph API uç noktalarını kullanacak şekilde güncelleyin
- Kamuya açık hizmetler geliştiriyorsanız Meta Uygulama İncelemesi üzerinden yeni izinler talep edin
- Kaldırma son tarihinden önce kapsamlı test edin
🚀 İleri Düzey Özellikler ve Özel API’ler
Çekirdek Graph API’nin ötesinde, Meta belirli kullanım durumları için özel API’ler sunar. Uygulamanız doğrudan mesajlaşma, reklam yönetimi veya gelişmiş içerik analizi gerektiriyorsa, bu tamamlayıcı API’ler yeteneklerinizi önemli ölçüde genişletir.
Instagram Mesajlaşma API’si (Messenger API üzerinden)
İşletme ve içerik üretici hesapları adına doğrudan mesaj gönderin ve alın; böylece manuel müdahale olmadan otomatik müşteri iletişimini sağlayın.
Desteklenen işlemler:
- Müşterilere mesaj gönderin
- Gelen Mesajları Webhook Bildirimleriyle Alın
- Çoklu Mesajlı Konuşmaları Yönetin
- Medya dosyaları gönderin, hızlı yanıtlar ve şablonlu mesajlar
Bu API, müşteri destek platformları, sohbet botu entegrasyonları, sipariş bildirimleri ve otomatik yanıt sistemleri kurmak için idealdir. Mesaj işleme hızı, Graph API hız sınırlarından bağımsızdır.
Instagram Reklam API’si (Pazarlama API üzerinden)
Instagram reklam kampanyalarını programlı olarak yönetin ve Instagram’da yayınlanan reklamlara ilişkin ayrıntılı performans metriklerine erişin.
Kapsamlar şunları içerir:
- Instagram kullanıcılarını hedefleyen reklam kampanyaları oluşturun ve yönetin
- Dönüşüm Takibi ve Hedef Kitle İçgörüleri
- Reklam performans metriklerini gerçek zamanlı izleyin
- Teklif optimizasyonu ve bütçe tahsisatını otomatikleştirin
Reklam API’si ek izinler ister ve çok sayıda reklam hesabını yöneten ajanslar ve platformlar için özellikle kullanışlıdır. Hız sınırları, reklam hesabı katmanınıza göre belirlenir.
🔧 Hatalar ve Yaygın Sorunlarla Başa Çıkma
İyi tasarlanmış entegrasyonlar bile hatalarla karşılaşır. Hataları zarifçe ele almak için bilmeniz gerekenler burada.
Yaygın Hata Kodları
Bir şeyler ters gittiğinde hata kodlarını anlamak hata ayıklamayı hızlandırır. Karşılaşacağınız en yaygın hatalar ve her biri için çözümler aşağıdadır:
| Hata Kodu | Tür | Sebep | Çözüm |
|---|---|---|---|
| 190 | OAuth Hatası | Geçersiz erişim belirteci | Token süresi doldu, iptal edildi veya geçersiz → Tokeni yenileyin veya yeniden kimlik doğrulayın |
| 200 | İzin Hatası | İzinler yetersiz | Uygulama bu işlem için gerekli izinlere sahip değil → İzin için Meta Uygulama İncelemesi üzerinden talepte bulunun veya gerekli kapsamı ekleyin |
| 100 | Geçersiz Parametre | Geçersiz istek | Gerekli parametreler eksik veya biçim hatalı → İstek biçimini düzeltin |
| 429 | Hız Sınırı Uygulanıyor | Çok fazla istek | Saatlik 200 istek sınırını aştı → Üssel geri çekme uygulayın |
API çağrılarını her zaman try-catch blokları içinde sarın ve hata yanıtlarını ayrıştırın:
{ "error": { "message": "Invalid OAuth access token", "type": "OAuthException", "code": 190 } }
SSS: Instagram Graph API Soruları ve Çözümleri
Graph API ile kişisel Instagram hesaplarına erişebilir miyim?
İşletme Girişi ile Facebook Girişi arasındaki fark nedir?
Erişim jetonları ne kadar sürer?
Rate limitinizi aştığınızda ne olur?
Tüm API çağrıları oran sınırınıza mı sayılır?
API Çağrılarını Nasıl En Aza İndirir ve Hız Sınırlarında Nasıl Kalırsınız?
Daha fazla yardıma mı ihtiyacınız var? Resmi Instagram Platform belgelerini inceleyin veya deneyimli geliştiricilerden çözümler için Meta Geliştirici Topluluğu’ndan yardım isteyin.
📈 En İyi Uygulamalar: Güvenilir Instagram Entegrasyonları Nasıl Oluşturulur
Kırılgan bir entegrasyon ile üretime hazır bir sistem arasındaki fark, uç durumlar, hız sınırları ve güvenliği nasıl ele aldığınıza bağlıdır. Bu uygulamalar opsiyonel değildir—gerçek dünya koşullarında başarılı entegrasyonları, başarısız olanlardan ayıran şey budur.
- Her zaman uzun ömürlü jetonlar kullanın. Kısa ömürlü jetonlar güvenilir uygulamalar için çok hızlı bir şekilde süresi doluyor.
- Kapsamlı hata yönetimini uygulayın. API çağrılarının başarılı olacağını varsaymayın; 429, 190 ve diğer hataları zarifçe yönetin.
- İlk günden hız sınırlarına göre tasarlayın. Önbellekleme, toplu işlemler ve webhooks’i baştan mimarinize dahil edin.
- Kimlik bilgilerini güvenli saklayın. Tokenleri sürüm kontrolüne asla eklemeyin; ortam değişkenleri ve şifreli depolama kullanın.
- Hız sınırı tüketimini izleyin. Saatlik kota yüzde 80’e yaklaşırken uyarılar kurun.
- Geliştirme modunda kapsamlı test edin. Meta uygulamaları geliştirme modunda başlar ve sınırlı yeteneklere sahiptir; canlı moda geçerken nelerin değiştiğini anlayın.
- Document your API usage. Kullandığınız uç noktaları, ne sıklıkta ve hangi amaçlarla kullandığınızı kaydedin.
Bu uygulamaları ilk günden bu yönergelere uyarak uygulamak, ileride maliyetli yeniden yazma ve acil hata ayıklama süreçlerinden sizi korur. Bunlar kısa yol değil — ölçeklenebilir, sürdürülebilir entegrasyonların temelidir.
İleriye Doğru
Instagram feeds on websites, building social media management tools, or creating analytics platforms, the Instagram Graph API provides the foundation for all professional Instagram integrations. Start with the authentication method that fits your use case, implement optimization strategies early, and scale your application with confidence.”> İster web sitelerinde Web sitelerindeki Instagram akışları gösterin, sosyal medya yönetim araçları geliştirin veya analiz platformları oluşturun; Instagram Graph API, tüm profesyonel Instagram entegrasyonlarının temelini sağlar. Kullanım durumunuza uyan kimlik doğrulama yöntemiyle başlayın, optimizasyon stratejilerini erken uygulayın ve uygulamanızı güvenle ölçeklendirin.
Graph API sürüm duyuruları ve kullanımdan kaldırmalar hakkında bilgi sahibi olun. Meta, genellikle önemli değişiklikleri 90 günden uzun bir bildirim süresiyle duyurur; böylece son tarihler uygulanmadan önce geçiş yapma şansınız olur.
