WordPress REST API'sine Giriş
Yayınlanan: 2017-01-13WordPress 4.7'nin piyasaya sürülmesi, toplulukta çok fazla heyecan yarattı ve bunun iyi bir nedeni var. Tanıtılan birçok iyileştirme ve özelliğin yanı sıra, asıl gösteri hırsızı REST API çekirdek entegrasyon duyurusuydu. Önceki yazılarda bahsettiğimiz gibi, bu WordPress'i bir blog platformundan bir İçerik Yönetim Sistemine (CMS) etkili bir şekilde dönüştürür. Ama bu dönüşüm nasıl olacak? Ve kullanıcılar için faydaları ne olacak?
Bu yazıda, önce size bazı temel kavramları tanıtacağız ve ardından size API ve web sitenizle nasıl oynamaya başlayabileceğinizi göstereceğiz.
Tüm müşterilerimizin web siteleri zaten WordPress 4.7.1'e yükseltildi. Öyleyse başlayalım!
API nedir?
API, Uygulama Programlama Arayüzü anlamına gelir. Yazılım geliştiriciler için LEGO blokları olarak işlev gören bir standarda uyan bir dizi belgelenmiş yapıdır. Bu yapılar veri yapıları, fonksiyon çağrıları, daha yüksek seviyeli bileşenler, hemen hemen her şey olabilir. Yazılım geliştiricileri, API'lerden daha karmaşık yazılımlar oluşturmak için kullanır. REST API'lerinde olduğu gibi, ister yerel olarak (yazılım kitaplıklarını düşünün) ister uzaktan İnternet'te barındırılsınlar, genellikle çeşitli yazılım bileşenleri arasında bir iletişim yöntemi olarak kullanılırlar.
İşletim sisteminden web'e kadar birçok farklı yazılım düzeyi için API'ler vardır.
REST API nedir?
REST, Temsili Durum Aktarımı anlamına gelir ve aynı birlikte çalışabilirliği ve bileşen iletişimini sağlar, ancak daha yüksek bir düzeyde: Web. REST ile Python, Java veya PHP ile yazılmış, farklı sistemlerde barındırılsalar bile birbirleriyle iletişim kuran ve veri alışverişi yapan çeşitli web tabanlı yazılımlara sahip olabilirsiniz. Her sistem REST “konuşmasını” bildiğinden, bilen herkesle konuşabilir!
REST, bir iletişim aktarımı olarak HTTP protokolünü ve temel işlemlerini uygulamak için standart HTTP isteklerini kullanır. Bu işlemlere fiil denir. En sık kullanılanlar şunlardır: PUT, GET, PATCH, DELETE. Bu fiiller, REST'in Kaynaklar olarak adlandırdığı şeylere etki eder. Yazılım geliştiricisi tarafından uygulanırlar ve depolama üzerinde çalışan dört temel bilgisayar işleminin tümünü etkin bir şekilde uygularlar: Oluştur, Oku, Güncelle, Sil ( CRUD ).
Veri gösterimi ve değişimi için REST, JSON ( Javascript Object Notation ) adlı hafif bir veri özelliği kullanır. JSON'un yapısı çok basittir. XML ve diğerlerinin bin sayfalık spesifikasyonuna kıyasla basitliği ve kullanım kolaylığı, geliştiriciler tarafından hemen benimsenmesini sağlayarak onu Web'in fiili veri alışverişi standardı haline getirdi.
WordPress bunu nasıl uygular?
Dolayısıyla Kaynaklar üzerinde etkili olan fiiller (Create, Read, Update, Delete) kavramına sahibiz. WordPress, platformda bulunan hemen hemen her ayrı bilgi öğesini bir REST Kaynağı olarak tanımlar. Bir sitenin kullanıcılarından ayarlara, gönderilere, gönderi sınıflandırmalarına, bildirimlere, medyaya, istatistiklere ve aradaki her şeye. Buna, bu Kaynaklar için tanımlanabilecek işlemler dahildir. Örneğin, yorumlar için tanımlanan işlemler şunlardır:
- Son yorumların bir listesini alın.
- Bir gönderiye yapılan son yorumların bir listesini alın.
- Tek bir yorum alın.
- Bir yorumu düzenleyin.
- Bir gönderiye yorum oluşturun.
- Başka bir yoruma yanıt olarak bir yorum oluşturun.
- Bir yorumu silin.
- Bir yorum için beğenileri alın.
- Bir yorum gibi.
- Bir yorumdan beğeninizi kaldırın.
- Bir yorum için beğeni durumunuzu alın.
API'nin genişliği ve derinliği hakkında fikir edinmek ve neler yapabileceğini kontrol etmek için WordPress'in resmi API dokümantasyon sayfasına kolaylıkla göz atın. Olasılıklar o kadar çok ki!
Böylece WordPress, üzerinde bulunan her bit veriyi bir REST Resource olarak ele alarak bir geliştirme platformu ve bir CMS haline gelir. Bunların hepsini , harici tarafların bunlar üzerinde CRUD işlemleri gerçekleştirmesine izin veren, genel, standartlaştırılmış bir API altında sunar. Bu şekilde, WordPress açılır ve Java, Python veya Ruby olsun, yazılım dünyasının geri kalanıyla birlikte çalışabilir hale gelir; ve REST kullanarak nasıl iletişim kurulacağını bilen hemen hemen her dil veya sistemle.
Kendiniz deneyin
Web sitenizin REST API'sini kurcalamaya başlamanın birkaç yolu vardır. Tarayıcınızda bir REST test eklentisi kullanmak için en kolayı. Etrafta birkaç tane var ama en popüler olanı Postacı (MacOSX, Windows ve Chrome için mevcut).
Örneğin, blogumuzun tüm gönderilerini içeren bir JSON nesnesini almak istediğinizi varsayalım. Bunu yapmak için, bu istek çağrısının Temel Rotasını bulmak için önce resmi WordPress REST Referansına başvurmanız gerekir (bu /wp/v2/posts ).
Şimdi yapmamız gereken tek şey şu:
- Açılır menüden GET'i seçin. Gördüğünüz gibi pek çok REST fiili var ama hepsini kapsamak bu makalenin konusu değil.
- Ekranda gördüğünüz URL'yi oluşturan Temel Rotayı ( /wp/v2/posts ) web sitenizin REST kök URL'sine (http://www.acme_shop_2.onpressidium.com /wp-json/ ) ekleyin.
- Gönder düğmesini tıklayın.
Her şey yolunda giderse, web sitenizin JSON yanıtını alttaki Gövde sekmesinde görebileceksiniz. Belgelere başvurarak farklı Temel Rotalar ve Fiiller ile denemeler yapabilirsiniz. WordPress REST API, geliştirici odaklı makalelerde bolca kullanacağımız gelecekteki gönderilerde kendimizle ilgileneceğimiz bir şeydir.
WordPress'in geleceği parlak!
Yıllar boyunca, WordPress büyük ölçüde gelişti ve kullanıcılara yeni olanaklar sağladı. Bireysel blog yazarlarından, gazetecilerden, yayıncılardan işletme sahiplerine ve şimdi diğer açık kaynak topluluklarından yazılım geliştiricilere kadar herkese. WordPress, kullanıcılarını güçlendirmeye devam ediyor. Aynı tutkuyla hareket eden, ancak farklı geçmişlerden gelen insanların neler başarabileceklerine dair bir örnek oluşturmaya devam ediyor. WordPress çekirdeğine REST API entegrasyonu, yalnızca yeni bir olasılıklar dünyası açmakla kalmaz, aynı zamanda yeni bir karmaşıklık dünyası yaratır . Yönetilen WordPress barındırma çözümümüzün asıl amacı budur, topluluğa katkımız budur. Sizi ve günlük girişiminizi etkinleştirmekle ilgilidir. Bu, tüm bu karmaşıklıkla mücadele etmek, her şeyi çalışır durumda tutmak ve her şey kaçınılmaz olarak bozulacakken orada olmakla ilgili.