API nedir?

Bir süredir teknoloji ile çalışıyorsanız, muhtemelen API terimiyle karşılaşmışsınızdır. Programlama yapan ve sıfırdan bir web sitesi yapmayı anlayanlar için API terimine çok aşina olacaksınız.

Web sitelerinde kullandığınız birçok popüler işlevin arkasında bir API bulunur. Uygulama Programlama Arayüzü anlamına gelen bir kısaltmadır. Farklı türde yiyecekler yapmak için bir tarif düşünmek iyi bir örnek olabilir. Her tarifin, yemeğin nasıl oluşturulacağına dair adım adım talimatları vardır. Bu, API ile ilgili koddur. Bir bilgisayar, bir görevi gerçekleştirmek için bir dizi yönergeyi izlemelidir.

Bu tarifi alıp herhangi bir şefe verebilirsiniz. Malzemeleri yorumlayabilecek ve tüm farklı unsurları bitmiş üründe nasıl birleştireceklerini anlayabileceklerdir. Yemek yapmayı anlıyorsanız ve mutfaktaki tüm araçları kullanmak için yeterli eğitime sahipseniz, tarifi bir araya getirmek için talimatları kendiniz takip etme seçeneğiniz bile var. Sonunda bir API, bilgisayarın nasıl takip edileceğini anladığı bir reçetedir.

Geliştiriciler ve API'ler

Bir API'nin nasıl çalıştığına ilişkin örneğimize devam ederek, bazıları tarifi, yiyecekleri hızla bir araya getirebilecek ve sipariş ettiğiniz yemeği size verebilecek profesyonel bir şefe getirecektir. Bir geliştirici, tarifi zaten oluşturabilen ve değiştirebilen bir kişi gibidir.

API, bilgisayara yönelik bir dizi talimattır. Kodlama deneyimine sahip bir geliştirici, API'nin bazı yönlerinde ince ayar yapabilir ve ihtiyaçlarını karşılayacak şekilde değiştirebilir. Bu, API'yi sitelerine eklemek isteyen pek çok kişinin kapsamı dışında olacaktır.

API kullanmak, günlük kullanıcılar için iyidir, çünkü kendi web sitelerinden kodu kendi başlarına oluşturmadan daha fazla işlevsellik elde etmelerine olanak tanır. Belki de web sitenizi ziyaret eden bir kullanıcı için hava durumunu ve saati görüntülemek istersiniz. Bu içerik dinamiktir ve statik değildir. Hava durumunu bir günlüğüne bırakıp bırakamazsınız. Değer her zaman değişir, bu nedenle bilgilerin güncellenmesi için bir API'ye erişmeniz gerekir.

API'ler ve WordPress

WordPress kullanıyorsanız ve bir API'yi entegre etmenin bir yolunu arıyorsanız, bunu bir WordPress eklentisi veya teması aracılığıyla yapmanızı öneririz. Birçok ücretsiz ve premium eklenti, API'leri kolayca entegre etmenize yardımcı olabilir. Ancak, ödemediğiniz sürece çoğu çok sınırlıdır.

Kendiniz kodlama bilgisine sahipseniz, WordPress sitenize harici bir API entegre etmek kolaydır. Bunun için Rapidapi'nin harici API'lerin nasıl entegre edileceğini açıklayan bu kılavuzunu öneriyoruz.

Dinamik İçerik

Dinamik içerikle uğraşırken ilk düşünceniz, hızla değişen bilgileri web sitenize besleyebilecek bir API bulmak olmalıdır. Ayrıca popüler programlarla daha derin bir düzeyde etkileşim kurmanıza izin verebilir.

Örneğin Twitter'ı ele alalım. Bu, sosyal medya ile ilgilenen insanlar için popüler bir platformdur. Dijital pazarlamanın bir parçasıysanız, şeylere daha derinden erişmek isteyeceksiniz. Twitter API'sini kullanarak, bilgileri hızlı bir şekilde e-tablolara çekerek, bunları parçalara ayırabilir ve kullanıcıların ilgi alanları ve kaç bağlantıya sahip oldukları gibi şeyleri anlayabilirsiniz. Dijital bir pazarlamacıysanız, belirli demografik özelliklerdeki insanları hızlı bir şekilde belirlemek isteyeceksiniz, böylece onlara hangi ürünleri sunacağınızı bileceksiniz. Twitter API, her şeyi elle derlemek yerine büyük miktarda bilgiyi bir kerede çekebileceğiniz için bunları yapmanıza olanak tanır.

Sitenizi Geliştirmek

Büyük bir şirket için bir API kullanarak işinizi nasıl geliştirebileceğinizi kısaca inceledik. Harici web sitelerinden başka neler çekebiliriz? Dinamik olarak değişen bir kullanıcı için hava durumunu yüklemenin yanı sıra, biraz daha ilginç bir şey gösterebiliriz.

Flickr'dan ve hatta Facebook'tan en son görüntüleri gösterebilen bir web sitesini nasıl istersiniz? Bu, kullanıcılarınız için ilgilenecekleri harika bir içerik olacaktır. Bunun için öncelikle Flickr için API belgelerini bulun. API'yi sitenize entegre etmekte sorun yaşarsanız, önce bunu yapmanız önemlidir.

Şimdi istediğiniz formatı talep etme yeteneğini göreceksiniz. Birçok API için REST, XML-RPC ve SOAP gibi seçenekleriniz olacaktır. Bu durumda, WordPress sitelerinde çok popüler olan REST'i seçin. Buna tıkladığınızda size bir Flickr REST API Endpoint sunulacaktır.

REST nedir?

REST, sitenizde dinamik ve sürekli değişen içeriğe sahip olmak isteyip istemediğinizi öğrenmek için başka bir kısaltmadır. REST ile GET, POST ve DELETE kullanabiliriz. Bu, Flickr'daki tüm veriler içindir, ancak Facebook, Google veya Instagram için de geçerlidir.

Kısaltma Temsili Devlet Transferi anlamına gelir. Hiper ortam dağıtmak için oluşturuldu ve ilk olarak 2000 yılında Roy Fielding ile sahneye çıktı. Artık sizin için veri alacak HTTP isteklerine sahip olabilirsiniz. HTTP istekleri, diğer web sitelerine de veri gönderebilir. API, iki bilgisayar programının birbirleriyle konuşurken ve iletişim kurarken konuştuğu dildir. Bu dili ve nasıl çalıştığını anlayarak hemen hemen her siteden veri çekebilirsiniz.

API Anahtarları

Web siteleri, WordPress sitenizde görüntülenecek verileri çekmeyi kolaylaştırmaz. İlk önce bir hesap oluşturmanız gerekir. Web sitesinde hesabınız olduğunda, onlardan bir API anahtarı isteyin. Hizmet şartlarını okuduğunuzdan emin olun. Hangi web sitesiyle çalıştığınıza bağlı olarak farklı olacak belirli terimler vardır. Bazı siteler, belirli bir zaman aralığında yapabileceğiniz HTTP GET istekleri sayısını sınırlayacaktır.

Belki de belirli bir gün için yalnızca 50 GET isteğiyle sınırlandırılmışsınızdır. Bu, sunucuların kaynaklar üzerinde istekte bulunmak isteyen kişiler tarafından sürekli olarak dövülmemesini sağlar. Pro sürümüne veya ticari sürümüne giderek bu gibi limitleri birçok kez artırabilirsiniz. Yükselttiğinizde, sunucuları çağırmak için kullandığınız daha fazla HTTP isteğine erişebileceksiniz. Bu, genellikle çok sayıda arama yapması gereken bir işletme tarafından kullanılır ve yalnızca sitelerinde yeni bilgiler görüntülemeye çalışan normal bir kullanıcı için geçerli değildir.

İzin Başvurusu

Bir API anahtarına sahip olmak için her zaman izin alamayacaksınız. Bazı siteler, anahtara neden erişmek istediğinizi uygulamanızı ve nedenini açıklamanızı gerektirir. Geliştiriciler, kendi ürün ve hizmetlerini tanıtmaya yardımcı olmak için aramaları aktif olarak kullanmadıkça, şirketler kaynaklarına büyük bir yük binmesini istemezler. Hatta bir ekibin isteğinizi gözden geçirmesini bile sağlayabilirler. Teknolojiye aşina olmak istiyorsanız, gereksinimlerin düşük olduğu bir Flickr sitesinden erişim talep edin. Artık anahtarınız ve kodunuz yanında olacak.

Kimlik doğrulama ve API'ler

Ardından, kimlik doğrulama gerektiren verileri almak için API'yi kullanmak isteyip istemediğinizi düşünün. Örneğin, size resim ve metin gönderme olanağı sağlayan bir Facebook veya Instagram API'sı kullanacak olsaydınız, bunun kimliğinin doğrulanması gerekir. Bu neden? Pekala, eğer bu şekilde düşünürsen, normal olarak Facebook'ta paylaşım yapmak için bir hesabına ihtiyacın olur. Sitede anonim olarak yayın yapamazsınız. Benzer şekilde, sizin adınıza bir API yayınlıyorsa, içeri girmek için bir kullanıcı adı ve şifre ile kimliğinizin doğrulanması gerekir. Bu, sizi tanımlayacak ve olmaması gereken şeyler yayınlanırsa, yayınlanan içerik size geri bağlanacaktır.

Çoğu sistem, protokolün kullanımı kolay olduğundan ve kullanıcılara API'nin bir web sitesiyle proxy olarak etkileşim kurması için basit bir yol sağladığından, kimlik doğrulama için OAuth'u kullanır. Bilgiler, kullanıcının kimliğinin açığa çıkmaması için güvenli bir bağlantı üzerinden gönderilir. Yine de, her zaman kimliğinizin doğrulanması gerekmez.

Hepsini bir araya koy

Artık API çağrıları yapmaya başlamak için ihtiyacımız olan tüm parçalara sahibiz. WordPress'te Görünüm'e ve ardından Widget'lara erişin. Bunlar PHP ile yazılmıştır. Web sitesinden aldığınız API belgelerini kullanarak istekte bulunmaya başlamak için yapıştırın. Flickr API kullanılması durumunda, URL https://flickr.com/services/rest gibi görünür.

Kodda, API anahtarınız için bir satır görürseniz, bunu talep ettiğiniz ve parolanızı ve anahtarınızı aldığınız andan itibaren kopyalayın. Verileri bir siteden geri aldığınızda, bunlar HTML, XML, Metin veya JSON biçiminde olabilir. Bu biçimlerin tümüne tam olarak aşina olmadığınızı varsayalım; bu iyi. Birlikte çalışabileceğiniz ve daha sonra yorumlayabileceğiniz birini seçin.

Verilere Bakmak

Verileri almak için gerekli bilgileri yapıştırmayı bitirdikten sonra, verileri okumak ve bilgileri ekrana çıkarmak için bir PHP dosyasına veya WordPress dosyasına da ihtiyacınız olacaktır. Bir kez daha, birlikte çalıştığınız şirketin sitesindeki API belgelerine geri dönün. Verileri metin olarak okuyabileceğiniz veya WordPress sitenizde resim olarak görüntüleyebileceğiniz bir biçimde çıkaracak bir kod bloğu olmalıdır.

Verileri Biçimlendirme

Verilerin sitenizde göründüğünü gördüğünüzde, garip görünebilir. Biçimlendirme yalnızca ham veri akışıdır. Harici bir siteye API çağrısı yaptığınızda, siteyi hoş görünecek şekilde biçimlendirmek için herhangi bir girişimde bulunulmaz. Verileri prezentabl görünecek şekilde şekillendirmek istiyorsanız, her şeyi cilalamaya yönelik bir CSS dosyası kullanabilirsiniz. CSS'yi yazarken sorun yaşıyorsanız, size bir yön vermek için çevrimiçi örnekler bulabilirsiniz. WordPress sitenizin erişebilmesi için kodu CSS dosyanıza kopyalayın.

Çözüm

Bu, bir API'yi WordPress sitenize nasıl entegre edeceğinize dair kısa bir eğitimdi. Konu karmaşıktır ve kodu kopyalarken bile zor olabilir. Sorun yaşıyorsanız bazı çevrimiçi sitelere giriş yapın ve daha fazla inceleme ve eğitim için Süper Temalara geri dönmeyi unutmayın.