Wprowadzenie do WordPress REST API

Opublikowany: 2017-01-13

Wydanie WordPressa 4.7 wywołało wiele emocji w społeczności i nie bez powodu. Oprócz wielu wprowadzonych ulepszeń i funkcji, prawdziwym złodziejem pokazów była zapowiedź integracji rdzenia REST API. Jak wspomnieliśmy w poprzednich postach, skutecznie przekształca to WordPressa z platformy blogowej w system zarządzania treścią (CMS). Ale jak nastąpi ta transformacja? A jakie będą korzyści dla użytkowników?

W tym artykule najpierw przedstawimy kilka podstawowych pojęć, a następnie pokażemy, jak zacząć bawić się interfejsem API i witryną internetową.

Wszystkie strony internetowe naszych klientów zostały już zaktualizowane do wersji WordPress 4.7.1. Więc zacznijmy!

Co to jest API?

API to skrót od Application Programming Interface . Jest to zestaw udokumentowanych struktur zgodnych ze standardem funkcjonującym jako klocki LEGO dla twórców oprogramowania. Te struktury mogą być strukturami danych, wywołaniami funkcji, komponentami wyższego poziomu, praktycznie wszystkim. Twórcy oprogramowania używają interfejsów API do tworzenia z nich bardziej złożonego oprogramowania. Są one często używane jako metoda komunikacji między różnymi komponentami oprogramowania, niezależnie od tego, czy są hostowane lokalnie (pomyśl biblioteki oprogramowania), czy zdalnie w Internecie, jak ma to miejsce w przypadku interfejsów API REST.

Istnieją interfejsy API dla wielu różnych poziomów oprogramowania, od systemu operacyjnego po sieć.

Co to jest REST API?

REST oznacza REpresentational State Transfer i umożliwia tę samą interoperacyjność i komunikację komponentów, ale na wyższym poziomie: sieci Web. Dzięki REST możesz mieć różnorodne oprogramowanie internetowe napisane w Pythonie, Javie lub PHP, komunikujące się i wymieniające między sobą dane, nawet jeśli są hostowane w różnych systemach. Ponieważ każdy system wie, jak „mówić” REST, może rozmawiać z każdym, kto to robi!

REST używa protokołu HTTP jako transportu komunikacyjnego i standardowych żądań HTTP do implementacji swoich podstawowych operacji. Te operacje nazywane są czasownikami. Najczęściej używane to: PUT, GET, PATCH, DELETE. Te czasowniki działają na rzeczach, które REST nazywa Resources. Są one wdrażane przez programistę i skutecznie realizują wszystkie cztery podstawowe operacje komputerowe, które działają na pamięci masowej: tworzenie, odczyt, aktualizacja, usuwanie ( CRUD ).

Hostuj swoją stronę internetową z Pressidium

60- DNIOWA GWARANCJA ZWROTU PIENIĘDZY

ZOBACZ NASZE PLANY

Do reprezentacji i wymiany danych REST używa lekkiej specyfikacji danych o nazwie JSON ( Javascript Object Notation ). Struktura JSON jest bardzo prosta. Jego prostota i łatwość użycia, w porównaniu z tysiącstronicową specyfikacją XML i innych, sprawiły, że został natychmiast przyjęty przez programistów, co czyni go de facto standardem wymiany danych w Internecie.

Jak WordPress to implementuje?

Mamy więc pojęcie czasowników (Create, Read, Update, Delete) działających na zasobach. WordPress definiuje jako zasób REST prawie każdy dyskretny element informacji, który istnieje na platformie. Od użytkowników witryny po ustawienia, posty, taksonomie postów, powiadomienia, media, statystyki i wszystko pomiędzy. Obejmuje to operacje, które można zdefiniować dla tych zasobów. Na przykład operacje zdefiniowane dla komentarzy są następujące:

  • Uzyskaj listę ostatnich komentarzy.
  • Uzyskaj listę ostatnich komentarzy do posta.
  • Uzyskaj jeden komentarz.
  • Edytuj komentarz.
  • Utwórz komentarz do posta.
  • Utwórz komentarz jako odpowiedź na inny komentarz.
  • Usuń komentarz.
  • Zdobądź polubienia za komentarz.
  • Jak komentarz.
  • Usuń polubienie z komentarza.
  • Uzyskaj status polubienia za komentarz.

Zajrzyj na oficjalną stronę dokumentacji API dla WordPressa, aby poczuć rozpiętość i głębię API oraz sprawdzić, co potrafi. Możliwości jest tak wiele!

W ten sposób WordPress staje się platformą programistyczną i CMS , traktując każdy bit danych, które na nim istnieją, jako zasób REST . Udostępnia je wszystkie w publicznym, ustandaryzowanym interfejsie API, umożliwiając zewnętrznym podmiotom wykonywanie na nich operacji CRUD . W ten sposób WordPress otwiera się i staje się interoperacyjny z resztą świata oprogramowania, czy to Java, Python czy Ruby; i prawie w każdym języku lub systemie, który wie, jak komunikować się za pomocą REST.

Wypróbuj sam

Istnieje kilka sposobów, dzięki którym możesz zacząć majstrować przy REST API swojej witryny. Najłatwiejszy w użyciu plugin testujący REST w przeglądarce. Jest ich kilka, ale najpopularniejszym jest Postman (dostępny dla MacOSX, Windows i Chrome).

Załóżmy na przykład, że chcesz pobrać obiekt JSON zawierający wszystkie posty naszego bloga. Aby to zrobić, musisz najpierw zapoznać się z oficjalnym dokumentem WordPress REST Reference, aby znaleźć podstawową trasę tego wywołania żądania (jest to /wp/v2/posts ).

  Wszystko, co musimy teraz zrobić, to:

  1. Wybierz POBIERZ z menu rozwijanego. Jak widać, dostępnych jest wiele czasowników REST, ale omówienie ich wszystkich nie jest tematem tego artykułu.
  2. Dołącz trasę podstawową ( /wp/v2/posts ) do głównego adresu URL REST witryny (http://www.acme_shop_2.onpressidium.com /wp-json/ ), tworząc adres URL widoczny na ekranie.
  3. Kliknij przycisk Wyślij .

Jeśli wszystko pójdzie dobrze, zobaczysz odpowiedź JSON swojej witryny na karcie Treść poniżej. Możesz eksperymentować z różnymi bazowymi trasami i czasownikami, zapoznając się z dokumentacją. WordPress REST API to coś, czym zajmiemy się w przyszłych postach, w których będziemy go szeroko wykorzystywać, w artykułach bardziej zorientowanych na programistów.

Przyszłość WordPressa jest jasna!

Przez lata WordPress bardzo się rozwinął i dał użytkownikom nowe możliwości. Do wszystkich, od indywidualnych blogerów, dziennikarzy, wydawców po właścicieli firm, a teraz do programistów z innych społeczności open source. WordPress wciąż wzmacnia swoich użytkowników. Nadal stanowi przykład tego, co ludzie mogą osiągnąć, kierując się tą samą pasją, ale pochodzą z różnych środowisk. Integracja REST API z rdzeniem WordPress nie tylko otwiera nowy świat możliwości, ale także tworzy nowy świat złożoności . Na tym właśnie polega nasze zarządzane rozwiązanie hostingowe WordPress, to jest nasz wkład w społeczność. Chodzi o umożliwienie Tobie i Twojej codziennej działalności . Chodzi o walkę z całą tą złożonością, utrzymanie wszystkiego w ruchu i brzęczenie oraz bycie tam, gdy rzeczy nieuchronnie się załamią.