WordPress REST API'sine Giriş

Aralık 2016'da, WordPress 4.7'nin piyasaya sürülmesiyle, uzun süredir tartışılan bir dönüm noktası gerçekleşti: WordPress REST API, resmi olarak WordPress Core'un bir parçası olarak dahil edildi.

REST API, çekirdeğe resmi olarak dahil edilmeden önce bir eklenti olarak var olmasına rağmen, daha sonra dahil edilmesi, hem dahil edilmesi hem de daha fazla test edilmesi gerektiği konusunda yapılan tartışmalarla birlikte oldukça fazla tartışmaya yol açtı.

Nihayetinde REST API, Core ile birleştirildi ve artık Block Editor'ın yanı sıra birçok 3. taraf entegrasyonuna ve web'deki WordPress siteleriyle arayüzlere güç veriyor.

Bununla birlikte, birçok WordPress kullanıcısı için, WordPress'e bu kadar sıkı bir şekilde entegre edilmiş bir şey şöyle dursun, herhangi bir türden REST API'sini ilk kez duyuyorlardı.

Bu nedenle, bu makalede, bir REST API'nin ne olduğuna, WordPress REST API'nin nasıl benzersiz olduğuna ve nasıl çalıştığına dair bazı örneklere ve artık WordPress'e dahil edildiğinden etkinleştirilen bazı teknoloji türlerine bir göz atacağız. Çekirdek.

REST API nedir?

REST API terimi aslında bir arada iki kısaltmadır ve her ikisi de WordPress REST API'nin nasıl çalıştığını ve ne işe yaradığını anlamak için önemlidir.

DİNLENME nedir?

İlk bölüm olan REST, Temsili Durum Transferi anlamına gelir. Mümkün olduğu kadar basit bir şekilde ifade etmek gerekirse, bu, web üzerindeki iki ayrı kaynağın birbiriyle nasıl iletişim kurması gerektiğini tanımlayan bir özelliktir. Bu iki arayüz, iki farklı web sitesi, bir web sunucusu, bir mobil uygulama ve çok daha fazlası olabilir.

Bu belirtimi izleyen bir hizmete genellikle RESTful hizmeti denir ve bilgi talep eden istemcinin sunucunun durumu ve istemci ile sunucunun diğerlerinden nasıl daha modüler ve ayrı olabileceği hakkında hiçbir şey bilmesine gerek kalmamasını sağlamak için çalışır. İnternet üzerinden veri taşıma yöntemleri.

Temel olarak, bir geliştirici bir RESTful hizmetiyle etkileşime girdiğini bilirse, isteklerinin nasıl biçimlendirileceği ve karşılığında ne tür veriler alacakları konusunda belirli varsayımlarda bulunabilir, bu da birbirine bağlı teknolojiler geliştirirken çok yardımcı olur.

Bir RESTful hizmetini tam olarak neyin oluşturduğunu ve bu tür isteklerin nasıl yapıldığını daha derine inmek istiyorsanız, Codecademy'nin REST nedir adlı yazısını incelemenizi şiddetle tavsiye ederim.

API nedir?

API, Uygulama Programlama Arayüzü anlamına gelir ve adından da anlaşılacağı gibi, web üzerindeki diğer istemciler ve hizmetler için belirli bir uygulamayla etkileşim kurmaları için bir arayüz sağlar. Verilerin gönderilebileceği uç noktaları, genellikle URL'leri, bu URL'lerin herhangi bir veri döndürüp döndürmediğini veya sunucuda kaynak oluşturup oluşturmadığını ve bu uç noktalara erişmek için belirli bir kimlik doğrulama türünün gerekip gerekmediğini belirtir.

Günümüzde web'deki birçok popüler hizmet için API'ler, bir komut dosyasının veya kod parçasının bir kullanıcı varken aynı eylemi gerçekleştirmesine izin vererek, kullanıcının manuel olarak yapabileceği şeyi yapmak için otomatik bir yol sağlar. Örneğin, Reddit kullanıyorsanız ve göz attığınız birçok başlıkta aynı türde yorumlar yazarken kendinizi Reddit'te bu tür yorumlar için arayan ve standart yanıtınızı Reddit'in API'si aracılığıyla otomatik olarak gönderen bir komut dosyası oluşturabilirsiniz.

Altyapılarını bir API aracılığıyla açığa çıkaran kullanıcılar, bu tür görevleri otomatikleştirmek için kırılgan web kazıma yöntemlerine güvenmek zorunda kalmaz ve Reddit, API aracılığıyla kaynaklarına kimin eriştiğini, bunu ne sıklıkta yaptığını takip edebilir ve kontrol edebilir. hizmet şartları dışındaki kullanımlar için.

WordPress neden bir REST API'sine ihtiyaç duydu?

REST API'nin Core'un bir parçası olmasından önce WordPress'e API benzeri isteklerde bulunduysanız, admin-ajax kavramına aşina olabilirsiniz. Bu, her isteğin admin-ajax.php dosyası aracılığıyla yönlendirildiği, herhangi bir etkin eklenti veya tema geliştiricisinin kaydettiği belirli eylemleri kontrol ettiği ve ardından bu kayıtlı işlevleri istekleri yerine getirmek.

Tahmin edebileceğiniz gibi, bu, API benzeri istekler kullanan her geliştiricinin eklentisinin veya temasının bir parçası olarak bu işlevi etkinleştirdiği anlamına geliyordu ve bu işlevle etkileşim kurmak isteyen herkesin her bir eklentinin veya temanın nasıl olduğunu öğrenmesi gerekiyordu. inşa edilmiş. WordPress REST API, bu isteklerin yapılma şeklini standart hale getirmek ve WordPress Core'un kendisi ile etkileşime geçmek için kullanılabilecek çok daha geniş kapsamlı uç noktalar sağlamak için tanıtıldı.

WordPress REST API'sine örnek bir istek

WordPress REST API El Kitabı, kutudan çıkar çıkmaz WordPress REST API'sinde desteklenen uç noktaların tam bir listesini tutar. Ve tam bir listeye sahip olmak harika olsa da, biraz bunaltıcı olabilir. Herhangi bir API etkileşiminin en temel işlevi olarak kabul edilebilecek şeye bir göz atalım: API'nin temel kaynağını getirme. WordPress söz konusu olduğunda, bu kaynak gönderilir.

WordPress REST API'sinin tüm uç noktalarının önüne, kök etki alanı ile REST API El Kitabı'nın Base Route olarak atıfta bulunduğu şey arasında wp-json URL yolu eklenir. Bu, sitenin gönderilerini listelemek için uç noktaya erişiyorsak ve sitemizin URL'si example.com ise, https://example.com/wp-json/wp/v2/posts URL'sine bir istekte bulunmamız gerektiği anlamına gelir. https://example.com/wp-json/wp/v2/posts .

Bu URL'yi favori web tarayıcınıza yükleyerek veya Postman gibi bir API tarayıcısı kullanarak bir GET isteği yapmak, kullandığınız biçimde olmasalar da size API'den gelen gönderilerin bir listesini döndürür. ile. Tüm gördüğünüz uzun bir metin dizisiyse, JSON olarak bilinen bir veri formatına bakıyorsunuz demektir. API uç noktasına tarayıcınız aracılığıyla erişiyorsanız ve bu bilgilere daha okunabilir bir biçimde bakmak istiyorsanız, JSON Viewer uzantısını yüklemenizi tavsiye ederim. Bu, tarayıcınızdaki JSON çıktısını algılar ve daha kolay okuyabilmeniz için biçimlendirir. Bu yüklendiğinde, WordPress REST API'sinden veri sonrası çıktısını görmelisiniz ve ilk REST API isteğinizi başarıyla yaptınız!

WordPress REST API başka neler yapabilir?

Bir WordPress sitesindeki en son yayınların bir listesini almanın dışında, Endpoint Reference'a bakarak, WordPress REST API ile etkileşim kurmanın tonlarca başka yolu olduğunu göreceksiniz. Bir WordPress kullanıcısı olarak kimliğiniz doğrulandıysa, API aracılığıyla gönderiler yayınlayabilir, sitede kullanılabilen Temaların bir listesini alabilir, ayarları görüntüleyebilir ve düzenleyebilirsiniz ve ayrıca wp-admin aracılığıyla manuel olarak etkileşime girilebilecek diğer birçok işlevi kullanabilirsiniz. .

Eylem halindeki WordPress REST API'sinin bazı örnekleri

REST API aracılığıyla WordPress ile etkileşime girme yeteneğinin ortaya çıkarılması, artık WordPress'i içerik yönetimi için arka uç olarak kullanabilen çok çeşitli sitelerin kapılarını açtı.

TechCrunch : WordPress REST API'sinin duyurulmasından kısa bir süre sonra TechCrunch, sitesini başsız bir mimari kullanarak yeniden oluşturduğunu duyurdu. stil React uygulaması” ön uçta.

Blok Düzenleyici (Gutenberg) : Belki de çoğu kişinin faydalandığı REST API kullanımı WordPress Blok Düzenleyici'dir. Artık WordPress'teki genel düzenleyici, Blok Düzenleyici işlevlerinin çoğu, WordPress REST API uç noktalarıyla herhangi bir sorun olmadan etkileşime girebilmesi sayesinde etkinleştirilir.

Her türden topluluk projesi : REST API'nin bir çekirdekte birleştirilmesi ilk kez düşünüldüğünde, insanlardan REST API'yi nasıl kullandıkları hakkında daha fazla konuşmalarını isteyen bir halka açık çağrı yapıldı. Yanıtlar çok geniş kapsamlıydı; bu, WordPress kadar büyük bir topluluktan bekleyebileceğiniz bir şeydi, ancak daha önce müşterileri için WordPress içeriğini tüketebilecek mobil uygulamalar oluşturan kişilere göre daha etkileşimli arayüzlere sahip eklentilerden her şeyi içeriyordu.

Sarma

API kullanma konusunda herhangi bir deneyiminiz olmasa bile, muhtemelen kariyerinizin bir noktasında çalışması için WordPress REST API'sine dayanan bir şey kullanmışsınızdır. Arayüzler daha dinamik olmaya devam ettikçe ve web siteleri sayfa yüklenmesini gerektirmeyen daha fazla eyleme sahip olmaya başladıkça.

Artık WordPress REST API'nin ne olduğunu bildiğinize göre, onunla oluşturabileceğiniz bazı şeyler hakkında düşünebilirsiniz! REST API, daha da iyi WordPress temaları ve eklentileri oluşturmak için araç kutunuzda kesinlikle güçlü bir araç olabilir.

Neyin mümkün olduğuna dair biraz daha açıklamaya veya bazı örneklere ihtiyacınız varsa, belgelere bir göz atın ve hemen başlayın!