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
Facebook Geliştirici Portalı’na gidin ve “Giriş Yap”a 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ı
Zernio provides a single API that handles Facebook publishing (posts, images, videos, Reels) with built-in OAuth, so you don’t need to manage tokens or worry about rate limits yourself.”>Birden çok Sayfa’ya içerik yayımlıyorsanız erişim belirteçlerini, izinleri ve hız sınırlarını yönetmek hızla karmaşık hale gelebilir. Kurulumu atlayıp hemen paylaşmaya başlamak isterseniz, Zernio tek bir API sunar ve Facebook paylaşımını (yayınlar, görseller, videolar, Reels) yerleşik OAuth ile işler; böylece kendi belirteçlerinizi yönetmenize veya hız sınırlarından endişe duymanıza gerek kalmaz.
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. Böylece sayfadan oluşturulan gönderileri ve yorumları yayımlayabilir, sayfaya ait içerikleri görüntüleyebilir ve daha fazlasını yapabilirsiniz. Ayrıntılı bilgiler Pages API Belgelendirmesi’nde bulunabilir. Unutmayın, sayfayı yöneten veya gerekli görevi yerine getirebilecek bir uygulama kullanıcısından bir token gerekir.
Facebook Video API
Facebook tarafından sunulan iki tür vardır – Video API ve Live Video API. Her ikisi de bir uygulama kullanıcısı tarafından yönetilen sayfa, grup veya etkinliğe video gönderir. Video API, tek veya çok sayıda sayfa ve grup üzerinde kısa ve uzun videolar yayımlamak için tasarlanmıştır. Live Video API ise canlı yayın planlamak, bir kullanıcı profili, grup veya etkinlikte video akışı gerçekleştirmek ve izleyicilerle etkileşimde bulunmak için kullanılır. Elbette videonuzu veya canlı akışınızı nerede göstermek istediğinize bağlı olarak sayfalar, gruplar veya etkinlikler için erişim belirteçlerine ya da bunların bir kombinasyonuna ihtiyaç duyarsınız.
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
here.”>Facebook Haber Akışına erişim sağlamak ve bunu kullanmak için iki seçeneğiniz vardır. Tanımlanan Graph API, durum güncellemelerinin bulunduğu ayrı bir Kullanıcı Akışı’na erişim ve kullanıcı veya profil üzerinde paylaşılan gönderileri API üzerinden almak ile bağlantıları elde etme imkanı sunar. Bu konu hakkında daha fazla bilgi için here.’e bakabilirsiniz.
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.
İstersen görüntülenen yorumlar üzerinde daha fazla kontrol elde etmek için, Yorum Eklentisi tercihlerine göre ayarlayabilirsiniz.
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
Şu anda Facebook Marketplace’te yalnızca Araçlar ve Emlak kategorileri mevcut. 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, performansı artırmak için Lead API’yi geliştirici webhooks ile birlikte kullanmayı önerir. Bunun için bu makalede daha önce anlatıldığı gibi uygulamanızı oluşturmalı ve Facebook’tan onay almak için İnceleme’ye göndermelisiniz.
Facebook Analitik API
Help Centre.”>Bu çözüm, müşterilerinizin davranışını ve yolculuğunu mobil, web, botlar, çevrimdışı ve diğer kaynaklardan izleyip optimize etmenize yardımcı olur. Bunu uygulamak için Facebook SDK’yı uygulamanıza veya web sitenize entegre etmelisiniz. Analitik hakkında daha fazla bilgi için Yardım Merkezi‘ni inceleyin.
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 geliştirici API’lerinin tüm türlerinin belgelerine Facebook geliştirici portalının Docs bölümünden ulaşabilirsiniz. Graph API kök düğümlerinin tam listesi ise Facebook API Reference bölümünde yer alır. Her API belgesi, gereken izinler için kısa bir öğretici içerir ve ayrıca nasıl kullanılacağını ve uygulanacağını gösterir. İlgili belgenin Getting Started ve Guides bölümlerinde bulunabilir.
