- Konu sahibi
- #1
Instagram API erişimi, Meta uygulamanızı uygun Instagram giriş düzeniyle yapılandırıp hesabın izin verdiği işlemler için erişim belirteci almanızdır. Bu erişim, kullanıcı adı ve şifreyle herhangi bir hesabın verisini çekmek anlamına gelmez. Instagram Platform, işletme veya içerik üreticisi türündeki profesyonel hesaplara yöneliktir.
Önce iki soruyu yanıtlayın: Yalnız sahip olduğunuz/yönettiğiniz hesap için mi çalışıyorsunuz, yoksa müşteriler de kendi hesaplarını bağlayacak mı? Ayrıca profil veya medya okuma, yorum yönetimi ve içerik yayınlama gibi hangi işlemlere gerçekten ihtiyacınız var? Hesap kapsamı ile işlem izni farklı kararlardır.
Meta, yeni entegrasyonlar için Unified Login düzenini önerir. Instagram Login ve Facebook Page bağlantısına dayanan Facebook Login düzenleri de mevcuttur. Bu yolların belirteçleri, izin aileleri ve API ana makine adları aynı değildir; bir yoldan alınan örneği diğerine doğrudan taşımayın.
Kurgu örnekte bir panel, müşterinin profesyonel hesabındaki medyayı listelemek istiyor olsun. Müşterinin e-posta adresini kaydetmek, Instagram hesabına erişim vermez. Hesap, seçilen giriş akışında bağlanmalı ve gereken izinler alınmalıdır. Yayınlama gerekmiyorsa yalnız okuma ihtiyacı için gereksiz yayınlama izni istemeyin.
Bu tablo birinin her özellik için diğerinin yerine geçeceğini söylemez. Uygulamanızın ihtiyaç duyduğu uç noktayı seçtiğiniz düzenin belgesinde kontrol edin. Örneğin izin adı benzer görünse bile farklı izin ailesini kullanmak erişim sağlamaz.
Yalnız kendi yönettiğiniz hesaplarda Standard Access yeterli olabilir; her durumda müşteriye açık giriş ekranı geliştirmek zorunlu değildir. Bu durumda da panelin gerekli uygulama/giriş ayarları ve geçerli belirteçleri tamamlanmalıdır.
Önce giriş yolunu, API host'unu ve belirteç türünü karşılaştırın. Sonra hesabın profesyonel türünü, bağlanan hesap kimliğini ve gerçekten verilmiş izinleri denetleyin. Bir profil isteğinin çalışması yayınlama izni olduğu anlamına gelmez. Örnekte çalışan bir hesap bağlantısı veya başarılı canlı API denemesi iddia edilmiyor.
Geçersiz erişimi sürekli yeniden denemeyin. İlgili işi durdurup bağlantı durumunu gösterin ve gerekiyorsa yeniden yetkilendirme isteyin. Kullanıcının kaldırdığı izni uygulama kendi kendine geri alamaz.
Hayır. Kullanıcı, Meta'nın yetkilendirme ekranında hesabını bağlar. Uygulamanızın müşteriden Instagram şifresi toplaması veya saklaması bu API erişim akışının parçası değildir.
Önce iki soruyu yanıtlayın: Yalnız sahip olduğunuz/yönettiğiniz hesap için mi çalışıyorsunuz, yoksa müşteriler de kendi hesaplarını bağlayacak mı? Ayrıca profil veya medya okuma, yorum yönetimi ve içerik yayınlama gibi hangi işlemlere gerçekten ihtiyacınız var? Hesap kapsamı ile işlem izni farklı kararlardır.
Giriş düzenini uygulamanızla eşleştirin
Meta, yeni entegrasyonlar için Unified Login düzenini önerir. Instagram Login ve Facebook Page bağlantısına dayanan Facebook Login düzenleri de mevcuttur. Bu yolların belirteçleri, izin aileleri ve API ana makine adları aynı değildir; bir yoldan alınan örneği diğerine doğrudan taşımayın.
Kurgu örnekte bir panel, müşterinin profesyonel hesabındaki medyayı listelemek istiyor olsun. Müşterinin e-posta adresini kaydetmek, Instagram hesabına erişim vermez. Hesap, seçilen giriş akışında bağlanmalı ve gereken izinler alınmalıdır. Yayınlama gerekmiyorsa yalnız okuma ihtiyacı için gereksiz yayınlama izni istemeyin.
| Düzen | Hesap bağlantısı | API tarafında önemli fark |
|---|---|---|
| Unified Login | Instagram veya Facebook ile giriş; bağlı Facebook Page zorunlu değil, business portfolio gerekir | graph.facebook.com; bu düzene ait belirteç ve izinler |
| Instagram Login | Profesyonel hesap; Facebook Page zorunlu değil | graph.instagram.com; Instagram User belirteci ve instagram_business izin ailesi |
| Facebook Login | Facebook Page'e bağlı profesyonel hesap ve Page üzerinde gereken görev erişimi | graph.facebook.com; bu düzene uygun kullanıcı/Page belirteci ve izinler |
Bu tablo birinin her özellik için diğerinin yerine geçeceğini söylemez. Uygulamanızın ihtiyaç duyduğu uç noktayı seçtiğiniz düzenin belgesinde kontrol edin. Örneğin izin adı benzer görünse bile farklı izin ailesini kullanmak erişim sağlamaz.
Erişimi kurma sırası
- Meta for Developers üzerinde uygulamanızı oluşturup amacına uygun Instagram kullanım düzenini seçin. Uygulama ve Instagram hesabı kimliklerini birbirine karıştırmayın.
- Gereken hesap/işletme bağlantılarını tamamlayın. Facebook Login yolunda doğru Page ile Instagram profesyonel hesabının bağlantısını ve kullanıcının Page görevlerini doğrulayın.
- Kullanacağınız uç noktaların izinlerini listeleyin. Seçilen düzenin istediği geri dönüş adresini ve giriş yapılandırmasını kaydedin.
- Müşteri hesabı bağlanacaksa uygun OAuth akışını uygulayın. Kod, erişim belirteci ve hesap kimliği ayrı değerlerdir; kodu seçtiğiniz akışın belirteç değişim işlemiyle sunucu tarafında değiştirin.
- Uygulama sırrını ve sunucu belirteçlerini erişimi sınırlandırılmış biçimde saklayın. Kaynak deposuna, tarayıcıya veya hata günlüklerine yazmayın; geçerlilik ve yenileme davranışını aynı akışın belgesinden uygulayın.
- Önce izin verilen bir test hesabında küçük bir okuma işlemiyle bağlantıyı doğrulayın. Dönen kimliğin bağlanan hesapla eşleştiğini ve yalnız verilen izinlerle çalıştığını kontrol edin.
- Başkalarının hesaplarına hizmet verecekseniz gereken Advanced Access için App Review ve Business Verification süreçlerini tamamlayın. Test rollerinde çalışması üretim erişiminin onaylandığını göstermez.
Yalnız kendi yönettiğiniz hesaplarda Standard Access yeterli olabilir; her durumda müşteriye açık giriş ekranı geliştirmek zorunlu değildir. Bu durumda da panelin gerekli uygulama/giriş ayarları ve geçerli belirteçleri tamamlanmalıdır.
İlk kontrol başarısızsa
Önce giriş yolunu, API host'unu ve belirteç türünü karşılaştırın. Sonra hesabın profesyonel türünü, bağlanan hesap kimliğini ve gerçekten verilmiş izinleri denetleyin. Bir profil isteğinin çalışması yayınlama izni olduğu anlamına gelmez. Örnekte çalışan bir hesap bağlantısı veya başarılı canlı API denemesi iddia edilmiyor.
Sık sorulan sorular
Müşteri izni kaldırırsa eski belirteci tekrar deneyebilir miyim?
Geçersiz erişimi sürekli yeniden denemeyin. İlgili işi durdurup bağlantı durumunu gösterin ve gerekiyorsa yeniden yetkilendirme isteyin. Kullanıcının kaldırdığı izni uygulama kendi kendine geri alamaz.
Instagram şifresini panelimde saklamam gerekir mi?
Hayır. Kullanıcı, Meta'nın yetkilendirme ekranında hesabını bağlar. Uygulamanızın müşteriden Instagram şifresi toplaması veya saklaması bu API erişim akışının parçası değildir.
