Facebook API Nedir?
Facebook API, platforma veri almak ve çıkarmak için birincil yol olarak kullanılan çözümlerden oluşan bir paket. Geliştiriciler ve uygulama kullanıcıları bu ağın işlevselliğine şu kaynaklardan erişebilir: kullanıcı bilgileri, fotoğraflar ve videolar, mesajlar ve daha fazlası.
BONUS: Facebook Besleme Widget’ınızı birkaç dakika içinde oluşturun!
Facebook API Anahtarını Nasıl Elde Ederiz?
Facebook API anahtarına erişmek istiyorsanız, mevcut Facebook hesabınızla Geliştirici Portalı’nda kaydolmalı veya giriş yapmalı ve kimliğinizi onaylamalısınız. Bu işlem sadece birkaç basit adımla tamamlanacaktır:
- Adım 1. Giriş yapın veya hesap oluşturun
Geliştirici portalı için Facebook geliştirici portalı’na gidin ve “Giriş Yap” düğmesine tıklayın. Mevcut Facebook hesabınızla giriş yapabilir veya yeni bir hesap oluşturabilirsiniz
- Adım 2. Başlayın
Hizmetin içinde bulduğunuzda, ana sayfanın sağ üst köşesindeki “Başlat” düğmesine basın.
- Adım 3. Hesabınızı Doğrulayın
Geliştirici araçlarıyla çalışmaya başlamak için hesabınızı onaylamalısınız. Açılan pencerede “İleri” düğmesine basın.
Telefon numaranız veya kredi kartınızla hesabınızı doğrulayabilirsiniz. Telefon numarasıyla doğrulamak için, açılır menüden ülkenizi seçin, ülke kodu ile telefonunuzu girin ve “SMS olarak Gönder”e tıklayın. Edinilen kodu ilgili alana girin ve “Doğrula”ya tıklayın.
- Adım 4. Uygulamanızı Oluşturun
Hizmet, ilk uygulamanızı oluşturmanızı teklif edecek. Tüm Facebook API’leri ve Uygulama istatistikleri Geliştirici Paneli’nde izlenir ve bir uygulama oluşturmadan erişilemez.
- Adım 5. Uygulamaları Ekleyin veya Kendi İhtiyaçlarınız İçin Erişim Belirteçleri Oluşturun
Facebook API’lerini kullanmanın en kolay ve en pratik yolu, Uygulamaları doğrudan Kontrol Paneli’ne eklemektir. İhtiyaçlarınıza uygun olanı basitçe seçin.
Uygulamanızda kullanmak istediğiniz çeşitli API türleri için Erişim Belirteçleri oluşturmak için Araçlar – Graph API Explorer’a gidin. Ekranın sol kısmındaki açılır menülerden ihtiyacınız olan uygulamayı ve belirteç türünü seçin. Ardından “Erişim Belirteci Oluştur” düğmesini tıklayın. Uygulamanın sayfanıza erişimini onaylamanız gerekecek.
Facebook API Örneklerini Kullanma Rehberi
Ana ürün, diğer tüm Facebook API’lerinin temelini oluşturan Graph API’dir. Bunlar özünde Graph API’nin uzantılarıdır ve Facebook’un tüm ürünleri bu API ile bir şekilde etkileşir.
Facebook geliştirici konsolunu ve oradaki ürünleri nasıl kullanabilirsiniz? Bu sosyal platformun içeriği ve bazı işlevleriyle web sitenizi veya uygulamanızı geliştirmek için pek çok yol mevcut.
Kullanıcıları etkilemek ve eğlendirmek için web sitenizde veya uygulamanızda çeşitli sosyal medya içeriklerini — gönderiler, fotoğraflar, videolar — sergileyebilirsiniz.
Ancak Graph API başka kullanıcılar tarafından kullanılacak şekilde uygulanırsa, kullanıcıların önce bir açılır pencerede onay vermeleri gerekecektir. Bir kullanıcı yetki verdiğinde, uygulama bu kullanıcıdan bir erişim belirteci alacak ve Facebook profilinden onun bilgilerini kullanabilecektir.
Facebook API Sınırları
Her API türünün her zaman sınırlamaları vardır. Uygulama Erişim Belirteci ile yapılan Graph API sorguları, o uygulamanın hız sınırına sayılır. Her uygulamanın çağrı sayısı, bir saatlik pencerede yapabileceği istek miktarıdır ve şu şekilde hesaplanır:Bir saat içindeki çağrılar = 200 * Uygulama Kullanıcı Sayısı
Erişim belirteçlerini, izinleri ve hız sınırlarını yönetmek hızla karmaşıklaşabilir; özellikle birden çok Sayfa’ya yayın yapıyorsanız. Kurulumu atlamak ve hemen paylaşmaya başlamak istersen, Zernio tek bir API sunar ve Facebook paylaşımını (gönderiler, görseller, videolar, Reels) yerleşik OAuth ile yönetir; böylece belirteçleri yönetmek ya da hız sınırları konusunda endişe duymanız gerekmez.
Facebook API Entegrasyonu
Platform, Graph API temelinde geliştirici olmayan kullanıcılar için birkaç hazır çözüm sunar. Facebook uygulamaları ve API’si özünde Graph API düğümlerinin bir kümesi veya koleksiyonudur. Bu, hesap oluşturmak ve kontrol paneline erişim elde etmek için yukarıda tarif edilen 1-3 adımlarını tamamlamanız gerektiği anlamına gelir. Aşağıda en çok kullanılan Facebook standart API uygulamalarını açıklıyoruz.
Facebook Akış API Türleri
Facebook Sayfa API
Bu tür bir API, bir sayfanın ayarlarına, içeriğine ve metriklerine erişim sağlar. Bu, sayfadan oluşturulan ve görüntülenen gönderiler, yorumlar, sayfa sahibi içerik ve daha fazlasını yaratmanıza ve görüntülemenize olanak tanır. Tüm ayrıntılar için Sayfalar API Belgeleri bölümüne bakabilirsiniz. Unutmayın, sayfayı yöneten veya gerekli görevi yerine getirebilecek bir uygulama kullanıcısından bir belirtece (token) ihtiyacınız var.
Facebook Video API
Facebook tarafından sunulan iki tür vardır – Video API ve Live Video API. Bunlar, bir uygulama kullanıcısı tarafından yönetilen bir sayfa, grup veya etkinlik üzerinde videolar paylaşır. Video API, tek bir sayfada veya birden çok sayfada ve gruplarda kısa ve uzun videolar yayımlamak üzere tasarlanmıştır. Live Video API ise canlı yayın planlamak, bir kullanıcı profili, grup veya etkinlikte bir video akışı gerçekleştirmek ve izleyicilerle etkileşimde bulunmak için kullanılır. Ve tabii ki videonuzu veya canlı akışınızı nerede paylaşmak istediğinize bağlı olarak sayfalar, gruplar veya etkinlikler için erişim belirteçlerine ya da bunların bir kombinasyonuna ihtiyacınız vardır.
Facebook API Etkinlikleri
Bu tür API, Graph API işlevselliği olarak da sunulur ve yalnızca Facebook Pazarlama Ortakları için kullanılabilir. Ayrıca bu Etkinliği oluşturan Grubun yöneticisinden bir erişim jetonu da gerekir.
Facebook Haber Akışı API
Facebook haber akışına erişmenin ve kullanmanın iki yolu var. Açıklanan Graph API, durum güncellemelerinin ayrı bir Kullanıcı Akışı’na erişim ve kullanıcının veya profilindeki başka bir kişinin paylaşımlarını içeren gönderi API’leri ve bağlantılar elde etme imkanı sunar. Hakkında daha fazla bilgi için buraya tıklayın.
Ayrıca Public Feed API de bulunmaktadır; bu, üçüncü taraf hizmetinde veya web sitesinde ‘Public’ olarak işaretlenen içeriğin görüntülenmesini sağlar. Ancak bu tür bir API anahtarı yalnızca onaylı medya yayıncılarına verilir, bu nedenle önce başvurmanız gerekir.
İçeriğini web sitenizde göstermek için Facebook Grup API’sine ihtiyacınız yok. İçeriğini sitenizde görüntülemek için Facebook İçerik Akışı Widget’ı! Bu araçla ihtiyacınız olan içerik üzerinde tam kontrole sahip olursunuz.
Facebook Topluluk API’si
Facebook Yorum API
Facebook’daki yorumlara Graph API üzerinden erişim elde edilebilir. Yorumlar farklı içerik türleri altında bırakılabildiğinden, yorumlarla çalışmak için üzerinde işlem yapacağınız bir nesneye erişim elde etmelisiniz.
Facebook Yorumlar API’si
Bu bölüm Graph API’de, öneri içeren nesneleri temsil eder. Varsayılan alanlar arasında tarih, yıldız derecelendirmesi, inceleme metni, kullanıcı bilgileri ve ‘pozitif’ veya ‘negatif’ rozet bulunur.
Görüntülenen incelemeler üzerinde daha fazla kontrole sahip olmak istiyorsanız, İnceleme Eklentisi tercihleriniz doğrultusunda ayarlanabilir.
Facebook Araç API’leri
Facebook Giriş API’si
Facebook API giriş örneği, kayıt gerektiren pek çok web hizmetinde görülebilir. Bu, kullanıcılara bir web sitesine veya uygulamaya hızlı ve güvenli bir şekilde giriş yapma imkanı sunar. Bu API, kullanıcıların profil bilgilerini almak için erişim belirteçlerini toplar ve bu yalnızca kullanıcı onayıyla mümkündür. Bu tür bir API kullanmak istiyorsanız, uygulamanızın Facebook yönetimi tarafından incelenip onaylanması gerekir.
Facebook Yerler API
Places Graph, Android ve iOS için ayrı bir Facebook çözümüdür. Uygulamanız bu sayede kullanıcıların mevcut konumuna ilişkin bilgi edinebilir. Ayrıca mekanları arama ve keşfetme, konum paylaşımı ve coğrafi etiketleme özelliklerini de sağlar. Places API ayrıca kullanıcılardan erişim belirteçleri edinmeyi gerektirir. Places API ile entegre olmak ve çalışmaya başlamak için öncelikle uygulamanız için Facebook SDK’sını edinmelisiniz.
Facebook Ödemeler API’si
Ödeme API’si, belirli bir uygulamada yapılan bir ödemenin ayrıntılarını içerir. Bu ödemeler Facebook ödemelerinde oluşturulur ve platform üzerinden işlenir. Bu tür bir API, ödeme oluşturan bir uygulama için de bir erişim belirteci gerektirir.
Facebook Messenger API
Messenger API, Facebook Messenger aracılığıyla web sitenizde bir sohbet kanalı kurmanıza olanak tanıyan bir uygulamadır. Messenger API çözümü, geliştiricinin kullanıcılarla yönlendirilmiş bir sohbet kurmasına da olanak tanır. Böylece Messenger, Send API’yi (Facebook Bot API olarak da bilinir) kullanarak kullanıcıya otomatik yanıt verebilir; bu, Messenger’ın barındırıldığı sunucunun URL’sine webhook’lar gönderir.
Ziyaretçileriniz ve müşterilerinizle bağlantıda kalın — ücretsiz ve kolay kurulan Messenger Düğmesi!
Facebook Pazarlama API Türleri
Facebook Reklam API’si
Marketing API, Facebook üzerinde reklamları optimize etmeye yardımcı olan Graph API uç noktalarından oluşan bir paket. Facebook Ads API ise kullanıcıların reklam kampanyaları, reklam setleri ve ayrı reklam birimlerini oluşturmalarına ve yönetmelerine olanak tanır.
Facebook Marketplace API
Facebook Marketplace’te şu anda yalnızca Taşıtlar ve Emlak kategorileri bulunmaktadır. Facebook Marketplace. Facebook platformunun bu bölümüne erişmek için bir geliştirici hesabı oluşturmalı ve işletmenizi doğrulamalısınız. Bu çözüm, daha iyi performans için Lead API’yi geliştirici webhooks ile birlikte kullanmanızı önerir. Bunun için bu makalede daha önce açıklandığı gibi uygulamanızı oluşturun ve Facebook tarafından onaylanması için İnceleme’ye gönderin.
Facebook Analitik API
Bu çözüm, müşterilerinizin mobil, web, botlar, çevrimdışı ve diğer kaynaklardan davranışını ve yolculuğunu izleyip optimize etmenize yardımcı olur. Bunu uygulamak için Facebook SDK’yı uygulamanıza veya web sitenize entegre etmelisiniz. Analytics Yardım Merkezinde daha fazlasını öğrenebilirsiniz.
Facebook İşletme Yöneticisi API’si
En Son API Değişiklikleri
Facebook API changes include versioned changes – the ones that are introduced with the release of a new API version. There are also non-versioned changes that are introduced outside the normal releases. To upgrade to a higher Facebook API version there is a special API Upgrade Tool.
En son sürüm 8.0, Ağustos 2020’de yayımlandı. Şu özellikleri içerir:
- Uygulama türleri – İş, Oyun ve Hiçbiri
- Canlı Videolardan Beğeni Al
- Mağazalar için Messenger’da Ürün Şablonu: Ürünleri mesaj olarak göndermek için
Mayıs 2020’de yayımlanan önceki sürüm v7.0, Ağustos 2022’ye kadar kullanıma açık olacak.
Facebook API Durumu ve Hataları
Geçerli Platform durumu 1 Ekim 2020’den beri sağlıklı. Ancak yapılan istekler bazen ilgili hata kodlarıyla çeşitli Facebook API hata yanıtlarına yol açabilir. Örneğin 400 – Bad request – bir sorgunun artık desteklenmediği anlamına gelir ve yeni bir erişim belirteci oluşturmanız gerekir. İşte bazıları:
| Kod | Ad |
| 102 | API Oturumu |
| 1 | API Bilinmiyor |
| 2 | API Hizmeti |
| 3 | API Yöntemi |
| 4 | Çok Fazla API Çağrısı |
| 17 | API Kullanıcısı Çok Fazla Çağrı |
| 10 | API İzni reddedildi |
| 190 | Erişim belirteci süresi doldu |
| 200-299 | API İzni (İzinlere bağlı olarak birden çok değer) |
| 341 | Uygulama limiti aşıldı |
| 368 | Politika ihlalleri nedeniyle geçici olarak engellendi |
| 506 | Çift gönderi |
| 1609005 | Bağlantı Gönderme Hatası |
Facebook API Dokümantasyonu
Facebook geliştirici API’lerinin tüm çeşitlerinin belgeleri, Facebook Geliştirici Portalı’ndaki Belgeler bölümünde bulunabilir. Graph API kök düğümlerinin tam listesi ise Facebook API Referansı bölümünde yer alır. Her API belgesi, gerekli izinler hakkında kısa bir öğretici ve nasıl kullanılacağını ile uygulanacağını da açıklar. Bu bilgiler, ilgili belgelerin Başlarken ve Kılavuzlar bölümlerinde bulunabilir.
