Görsel odaklı platformuyla Instagram, işletmeler, geliştiriciler ve içerik oluşturucular için güçlü bir araç haline geldi. Kullanıcı deneyimini geliştirmek ve sorunsuz entegrasyonu kolaylaştırmak için Instagram iki temel araç sunar: Instagram Graph API ve Instagram Basic Display API. Bu makalede, Instagram Basic Display API'nin yeteneklerine ve Instagram varlığınızı optimize etmek için nasıl kullanılabileceğine odaklanacağız.
Instagram Basic Display API
Instagram Basic Display API, geliştiricilerin Instagram hesaplarından temel kullanıcı bilgilerine, medya içeriğine ve diğer verilere erişmesini sağlayan, Instagram (Facebook'un bir yan kuruluşu) tarafından sağlanan bir araçtır. Bu API, özellikle kullanıcı verilerine salt okunur erişimin gerekli olduğu senaryolar için tasarlanmıştır ve Instagram içeriğini görüntülemeye veya kişiselleştirilmiş deneyimler sunmaya odaklanan uygulamalar için uygundur.
API'ye erişmeden önce kurulum
Gereksinimler:
1. Bir Facebook geliştirici hesabı.
2. Bir test Instagram hesabı.
3. Uygulamanın Instagram'a erişim izni vermesi için bir web sayfası (URL) yönlendirmesi.
Kurulum adımları:
- Geliştirici sayfasında, Uygulama Oluştur'a tıklayın. Devam etmek için Diğer'i seçin.
2. Instagram basic display API için uygulama türü olarak müşteriyi seçin
Ardından, bilgilerinizi (Uygulama adı, iletişim e-postası) doldurun ve devam edin
3. Platform URL'sini ayarlayın. Ayar > temel'e gidin, alttaki platform ekle'ye tıklayın ve URL'nizi girin (Gereksinimde belirtilen web sayfası).
4. Kontrol panelinde Instagram Basic API'sini ayarlayın
Uygulama oluşturulduktan sonra, kaydedilmesi ve doldurulması gereken bazı şeylerle bir form görünecektir.
Uygulama Kimliği ve gizli anahtar daha sonra gerekecektir.
5. Bu uygulama test amaçlı olduğundan, Geçerli OAuth yönlendirme URI'si, Yetkilendirme kaldırma geri çağırma URL'si ve veri silme isteği alanlarına daha önce kullandığınız URL'yi girin.
Forma test kullanıcısı ekleyin, örneğin, Alice Bob'un bilgilerini almak istiyorsa, Bob hesabının kullanıcı adını girin.
Bir kullanıcı ekledikten sonra, kullanıcıdan yetkilendirme gerektiğinden kullanıcının durumu beklemede olacaktır. Test hesabını kullanmanız önerilir.
6. Test Instagram hesabınıza giriş yapın, ayarlar> web sitesi izni> Uygulamalar ve Web Siteleri> Test Davetleri'ne gidin. Test davetini kabul edin.
Temel kurulum tamamlandı!
Yetkilendirme nasıl istenir?
API'yi kullanmadan önce yetkilendirme koduna ihtiyaç vardır, bu yetkilendirme kodunun geçerlilik süresi 1 saattir. Kodu almak için, bu formdaki URL'yi girin:
https://api.instagram.com/oauth/authorize?client_id={app-id}&redirect_uri={redirect-uri}
&scope=user_profile,user_media
&response_type=codeÖzelliklerin açıklaması:
App-id: Uygulama kimliği, uygulama kimliğidir, bu, Instagram basic display uygulamasının altında bulunabilir.
redirect_uri: geçerli OAuth yönlendirme URI'si ile aynı URL.
Tüm URL için boşluk bırakmamayı unutmayın.
Enter'a tıkladıktan sonra, yetkilendirmeye izin verme sayfasına gidecektir.
Tüm erişime izin verdikten sonra, kendi URL'nize yönlendirilecektir, URL'ye eklenmiş kod parametresi ile, şöyle görünür
https://www.example.com/?code=ABCD......#_
Yetkilendirme kodu, code='dan sonrakidir, yetkilendirme kodunun parçası olmadığından #_'yi silmeyi unutmayın.
Apidog'u, kodu erişim token'ına dönüştürmek için nasıl kullanılır?
Apidog, API'nizi kolayca tasarlamanıza, test etmenize ve belgelemenize olanak tanıyan, hepsi bir arada bir API geliştirme platformudur. Instagram API'sini test etmek isteyenler için, Apidog kullanmak her zaman en kolay çözümdür.
Yetkilendirme kodunu erişim token'ına dönüştürün
Yöntemi POST olarak değiştirin, URL'yi girin:
https://api.instagram.com/oauth/access_token
Gerekli olan bu parametreleri ekledi:
- client_id = Instagram Uygulama Kimliği
- client_secret = Instagram Uygulama gizli anahtarı
- code = Alınan Yetkilendirme kodu
- grant_type = authorization_code (Bu değer ayarlanmıştır)
- redirect_uri = kendi URI'niz
Gönder'e tıklayın, erişim token'ı JSON dosyası şeklinde döndürülecektir, şöyle görünür:
{
"access_token": "IGQWR9......",
"user_id": 7666070400110123
}Not: token da 1 saat geçerlidir
Hesap bilgilerini sorgulamak için erişim token'ı ve kullanıcı kimliği nasıl kullanılır?
Instagram Display Basic API kullanılarak alınabilecek bir dizi özellik vardır, aşağıda bilgi alma ile ilgili iki örnek verilmiştir.
- bir hesabın temel bilgilerine erişin
curl kullanarak örnek istek:
curl -X GET \ 'https://graph.instagram.com/{user-id}?fields=id,username&access_token={access-token}'Parametre açıklaması:
- User_id: önceki adımdan alın
- Access_token: önceki adımdan
- Alanlar: kısmen isteğe bağlı olabilir. 4 tür alan mevcuttur:
1. Account_type: hesap türü
2. Id: user_id
3. Media_count: gönderi sayısı
4. Username: hesap adıBu dördünün tamamını almak istiyorsanız, hepsini virgülle (,) ayırarak girin
Dönüş sonucu:
2. Kullanıcının gönderi bilgilerini alın
Örnek istek:
curl -X GET \
'https://graph.instagram.com/me/media?fields=id,caption&access_token=IGQVJ...'Apidog'da kurulum:
Instagram display API ile ilgili daha fazla özellik için, şuraya bakın:
Sonuç
Sonuç olarak, Instagram API, geliştiricilerin Instagram platformuyla etkileşim kurması ve yenilikçi uygulamalar oluşturması için bir dünya dolusu olanak sunuyor. Kullanıcı bilgilerine ve medya içeriğine erişimden, yeni fotoğraf ve video yayınlamaya kadar, çeşitli uç noktalar, geliştiricilerin uygulamalarını belirli ihtiyaçlara göre uyarlamasına olanak tanır.
