WordPress API'leri: Nelerdir ve Nasıl Kullanılır?

WordPress JSON REST API, WordPress topluluğunda büyük ilgi uyandırdı ve hem geliştiricilere hem de içerik oluşturuculara yeni olanaklar sundu.

Kulağa karmaşık gelse de JSON, REST ve API gibi temel terimleri anlamak, WordPress'in geniş kapsamlı özellikleriyle etkileşim kurma şeklinizi kolaylaştırabilir.

API nedir?

API, esasen farklı yazılım uygulamalarının birbirleriyle iletişim kurmasına olanak tanıyan bir dizi programlama talimatı ve standardı olan "uygulama programlama arayüzü" anlamına gelir.

Bir yazılım uygulamasının diğerine talimat verdiğini düşünün; API, bu etkileşimi yöneten, üzerinde anlaşmaya varılan kurallar dizisidir. Bir yazılım diğerine talimatlar gönderdiğinde, API eylemi kolaylaştırır veya gerekli bilgileri sağlar.

API'yi, iki yazılım sistemi arasındaki, veri iletişimini ve görev yürütmeyi yöneten ancak son kullanıcı tarafından görülemeyen "kullanıcı arayüzü" olarak düşünebilirsiniz.

API örnekleri

Web uygulamaları geliştirirken bir API'ye erişime sahip olmak harikadır. Bir API'nin halka açık olması, geliştiricilerin yazılımın hizmeti tarafından desteklenen çözümler oluşturduğu anlamına gelir. Çoğu zaman, zaten yaratılmış olduklarından, birçok görev için tekerleği yeniden icat etme ihtiyacını ortadan kaldırırlar.

API'lerin harika bir örneği Amazon'dur. Amazon, geliştiricilerin ürünlere ve bilgilere kolayca erişebilmesi için API'sini yayınladı. Buna erişim, güncellenmiş fiyatlar ve satın alma seçeneğiyle Amazon'daki ürünlerin bağlantılarını yayınlamayı kolaylaştırır.

Etkileşime giren API'lerin bir başka örneği de konser bileti satın alımlarıdır. Resmi olarak bilet satın almak için kredi kartı bilgilerinizi girmeniz gerekmektedir. Kredi kartı bilgilerinizi uzaktaki bir uygulamaya göndermek için bir API kullanılır ve bu uygulama daha sonra kredi kartı bilgilerinin doğru olduğunu doğrular.

Her şey kontrol edildikten sonra uzak uygulama, bilet web sitesine devam etmenin sorun olmadığını belirten bir yanıt gönderir; bu noktada biletleri başarıyla satın almış olursunuz. Tüm bunlar olurken karşınıza sadece tek bir arayüz çıkıyor o da bilet sitesi. Bu kusursuz bir süreçtir; Perde arkasında birçok uygulama API'leri kullanarak birlikte çalışıyor, ancak kullanıcı olarak siz görevlerin bir uygulamadan diğerine devredildiğini fark etmiyorsunuz.

API'ler ve WordPress

Amazon ve bilet satın alma işlemleri API'lerin birlikte nasıl çalıştığına dair harika örneklerdir, ancak bu WordPress için nasıl geçerlidir?

Aslında aynı fikirlerin hepsi geçerli. WordPress API ile verileri WordPress'in içine ve dışına aktarabilir ve çekebilirsiniz.

API, geliştiricilerin WordPress web sitelerindeki verileri diğer web sitelerine veya uygulamalara kolayca paylaşmak için kullanabileceği önemli bir araçtır. Özellikle bu API, WordPress içeriğinde create , read , update ve delete (CRUD) işlemlerini gerçekleştirmenize olanak tanır. İçerik türlerine birkaç örnek:

• Gönderiler
• Özel gönderi türleri
• Sayfalar
• Taksonomiler
• Kullanıcılar
• Medya

REST ne anlama gelmektedir?

Burada uyuklama veya horlama yok; REST, bir API'nin mimari stilini ifade eder. REST, Temsili Durum Transferi anlamına gelir.

Programların birbirleriyle iletişim kurabilmesi için bir API'nin iletişimin ayrıntılarını verdiğinden nasıl bahsettiğimizi hatırlıyor musunuz? REST API'leri, bant genişliğinden tasarruf sağlayan hafif bir iletişim yöntemi sağlayacak şekilde tasarlanmıştır. WordPress JSON REST API tam da bunu yapar ve yüksek miktarda veri olduğunda onu harika bir seçenek haline getirir.

REST'in henüz yüzeyini çizdik; Daha fazla bilgi edinmek istiyorsanız bu REST yararlı eğitimine göz atın.

JSON biçimi

Verilere erişmek için yararlanacağımız bir kaynağa ihtiyacımız var. JSON'un devreye girdiği yer burasıdır. JSON, JavaScript Nesne Gösterimi anlamına gelir.

JSON'un hem insanlar hem de makineler tarafından okunması ve anlaşılması kolaydır. Bilgileri düzenli, erişimi kolay bir şekilde saklamanın mükemmel yoludur. JSON'a erişim çok basit olduğundan, bu onu REST API'leri oluşturmak için mükemmel bir seçim haline getirir ve WordPress JSON REST API'si için mükemmel bir çözümdür.

JSON formatının neye benzediğine dair temel bir fikir aşağıda verilmiştir:

[javascript]
{"çalışanlar":[
{“firstName”:”Jane”, “lastName”:”Smith”},
{“firstName”:”Anna”, “lastName”:”Olsen”},
{“firstName”:”Josh”, “lastName”:”Jones”}
]}

[/javascript]

WordPress'te JSON formatı

JSON yalnızca kendisini yazmaz, endişelenmeyin, JSON dosyasını manuel olarak oluşturmanıza gerek yoktur. Bunu sizin için oluşturabilecek eklentiler var. Bu araçlardan biriyle kullanıcılar, gönderiler, sayfalar, sınıflandırmalar ve daha fazlası dahil olmak üzere sitenin verileri doğru formatta olacaktır.

JSON REST API'sini kullanma

API'yi kullanmak oldukça açıklayıcıdır; sitenizin verilerini basit JSON formatında alacaksınız. Ve eğer yüklü bir eklentiniz varsa, sitenizdeki gönderileri veri biçiminde görerek denemeler yapabilirsiniz.

Verileri almak veya güncellemek, bir HTTP isteği göndermek kadar basittir. HTTP bir istek/yanıt protokolüdür. Öncelikle veri talebi gönderiyorsunuz ve ardından yanıt olarak veriler geri gönderiliyor.

GET yöntemi

GET yöntemi bilgi almak için kullanılır ve veriler üzerinde hiçbir etkisi yoktur. /wp-json/wp/v2/posts adresine bir GET isteği göndermeniz yeterlidir. Bir şey mi aramak istiyorsunuz? Örneğin, "geliştirme" arıyorsanız, GET isteğiyle /wp-json/wp/v2/posts?search=development sonuçlarını alırsınız.

POST isteği

Veri göndermek için POST isteği kullanılır. Örneğin yeni API'nin yetenekleriyle bir kullanıcıyı güncelleyebilirsiniz. Diyelim ki kullanıcıyı 10 kimliğiyle güncellemek istiyorsunuz. Tek yapmanız gereken /wp-json/wp/v2/users/10 adresine bir POST isteği göndermek.

Bunu denemek için bir Google Chrome uzantısı olan Postman'ı kullanmanızı öneririz.

Karışımda daha fazla Javascript var

Backbone.js ve API'ler

Backbone.js, REST API'leriyle çalışmak üzere tasarlanmış bir çerçeve olduğundan API ile çalışmanın harika bir yoludur. WordPress API, Omurga modellerini temel alan, kullanımı kolay bir Javascript API'si içerir. Bu, eklenti ve tema geliştiricilerinin çok fazla çaba harcamadan ve bağlantı kurmanın ayrıntıları hakkında bilgi sahibi olmadan çalışmaya başlamasına olanak tanır.

Çok daha fazlası var ancak Backbone, modeller, koleksiyonlar ve görünümler sağlayarak web uygulamalarına yapı kazandırır ve hepsini bir REST JSON arayüzü üzerinden WordPress API'sine bağlar.

Bu, WordPress geliştiricileri için ne anlama geliyor?

WordPress API'nin kullanıma sunulmasıyla birlikte onu kullanmanın yeni yolları arttı ve popülerlik kazandıkça da artmaya devam edecek. WordPress API, Javascript'e dayanan hemen hemen tüm mevcut WordPress işlevlerini geliştirebilir. İşte birkaç örnek:

• form doğrulama/gönderme
• Backbone.js temaları veya eklentileri
• sonsuz kaydırma

Ayrıca diğer kaynaklardan içerik göstermenin de harika bir yoludur. Artık çok siteli bir kurulumda tek bir sitedeki içeriği görüntülemek kolaydır. İçeriği tamamen ayrı bir WordPress sitesinden görüntülemek de mümkündür. İçeriği göstermenin yanı sıra içerik de daha kolay ve etkili bir şekilde güncellenebilir.

Artık bazı temel terminolojinin üzerinden geçtiğimize göre, JSON'un notasyon, REST'in mimari stil ve API'nin bunların oluşturduğu arayüz olduğunu biliyoruz. API'nin temellerini ve yeteneklerini bilmek, WordPress API ile yeni olanakları keşfederken iyi bir başlangıç ​​yapmanızı sağlayacaktır.