Zrozumieć WordPress REST API: Przewodnik dla programistów

Wprowadzenie

Tworzenie strony internetowej to złożony i wieloetapowy proces. Aby go rozpocząć, należy najpierw znaleźć wysokiej jakości rozwiązanie hostingowe. Jeśli zamierzasz stworzyć nową stronę internetową i nie masz bardzo dużego zapotrzebowania na zasoby i nie oczekujesz bardzo dużego ruchu, serwer VPS jest wszechstronnym rozwiązaniem, które będzie odpowiednie dla większości witryn. Jeśli metoda płatności ma dla ciebie znaczenie, powinieneś wiedzieć, że możesz wybierać spośród wielu opcji, takich jak VPS karty kredytowej, VPS bitcoin, AliPay VPS itp.

Kolejnym fundamentalnym aspektem tworzenia strony internetowej jest wybór CMS - systemu zarządzania treścią, specjalnego narzędzia, które służy do wypełniania strony treścią i modyfikowania jej. Jeśli wybór padł na WordPress, programiści będą mieli do czynienia z WordPress REST API.

Wordpress jest obecnie jednym z najpopularniejszych systemów CMS do tworzenia stron internetowych. Z kolei REST API jest niezbędnym interfejsem używanym do pracy z witryną Wordpress. Dzięki REST API, aplikacje otrzymują możliwość interakcji z witryną za pośrednictwem plików JSON. W ten sposób programiści mogą tworzyć niestandardowe aplikacje, strony internetowe i wtyczki na Wordpress. REST API pozwala programistom na interakcję z danymi Wordpress za pomocą poleceń HTTP.

Poniżej przyjrzymy się kilku niezbędnym poleceniom, które będą przydatne dla każdego dewelopera.

WordPress REST API: Podstawy

GET:

Służy do pobierania danych z bazy danych WordPress przy użyciu metody HTTP GET. Polecenie to jest jednym z najczęściej używanych, będąc pierwszym poleceniem używanym przed wykonaniem jakiejkolwiek operacji na danych.

Umożliwia pobranie określonego zasobu, takiego jak post, strona lub niestandardowy typ postu, bez modyfikowania go.

Aby skorzystać z tej metody, należy wysłać żądanie do określonego punktu końcowego z określonym zestawem parametrów. Punkt końcowy jest prezentowany przez adres URL zasobu z parametrami, które chcesz pobrać - na przykład identyfikator zasobu, opcje filtrowania, informacje o paginacji i inne parametry zapytania.

Jeśli to wpiszesz:

GET http://yoursite.com/wp-json/wp/v2/posts/983

otrzymasz szczegółowe informacje o poście z tym konkretnym identyfikatorem, takie jak jego tytuł, treść, autor i inne metadane.

Ponadto można uzyskać informacje na temat listy zasobów. Na przykład, jeśli chcesz zobaczyć wszystkie opublikowane, powinieneś dodać /wp/v2/posts?status=publish do żądania punktu końcowego:

GET http://yoursite.com/wp-json/wp/v2/posts?status=publish

POST:

To polecenie służy do dodawania czegoś nowego do witryny. W rzeczywistości może to być post, ale można go również użyć do stron, komentarzy i innych załączników.

Aby utworzyć nowy post, dodaj /wp/v2/posts do punktu końcowego.

POST http://yoursite.com/wp-json/wp/v2/posts

Następnie, w ładunku, będziesz mógł dołączyć dane dla nowego postu, takie jak jego tytuł, treść, autor i inne metadane:

"title": "My New Post", "content": "This is the content of my new post.", "author": 1, "status": "publish"

PUT:

POST służy do tworzenia pustych wersji roboczych stron i postów. Aby zaktualizować je o nową zawartość, można użyć polecenia PUT. Polecenie to może być dalej używane do publikowania wcześniej utworzonych wersji roboczych.

Aby zobaczyć wszystkie bieżące wersje robocze, można użyć polecenia POST w ten sposób:

POST http://yoursite.com/wp-json/wp/v2/posts/?status="draft".

Następnie można użyć polecenia PUT, aby zmodyfikować status konkretnej wersji roboczej, wprowadzając jej identyfikator:

PUT http://yoursite.com/wp-json/wp/v2/posts/983

Spowoduje to dostęp do posta z opcją jego modyfikacji. Teraz musisz zmienić jego status z "wersja robocza" na "opublikuj":

"status" = "publikuj"

Dodatkowo można dodać do niego więcej treści za pomocą argumentu "status":

"status" = "publikuj" "treść" = "treść tutaj"

USUŃ:

Kolejne niezbędne polecenie używane do usuwania postów, stron, treści i użytkowników. Usunięty post zostanie najpierw umieszczony w koszu.

Aby usunąć konkretny post, na przykład ten utworzony powyżej, wpisz coś takiego:

DELETE http://yoursite.com/wp-json/wp/v2/posts/983

Jeśli chcesz usunąć post na dobre bez wysyłania go do kosza, dodaj po nim ?force=true:

DELETE http://yoursite.com/wp-json/wp/v2/posts/983?force=true

OPCJE:

Jeśli chcesz sprawdzić zasób pod kątem dostępnych dla niego opcji komunikacji, możesz użyć tego polecenia. Po wprowadzeniu polecenia, na wyjściu otrzymasz listę metod komunikacji, które są dostępne dla danego zasobu wraz z innymi istotnymi informacjami, takimi jak obsługiwane schematy uwierzytelniania, nagłówki żądań i typy zawartości.

GŁOWA:

Polecenie to umożliwia pobieranie nagłówków treści bez konieczności zajmowania się rzeczywistą treścią. W ten sposób deweloper może uzyskać niezbędne informacje o fragmentach treści, takie jak informacje o buforowaniu, typ treści i długość treści, bez konieczności ich pobierania.

PATCH:

To polecenie umożliwia aktualizację określonej części treści. Jest nieco podobne do PUT, ale nie trzeba w pełni zastępować określonego zasobu. W ten sposób można zaktualizować tytuł lub treść postu, a także metadane powiązane z użytkownikiem, podczas gdy reszta pozostaje niezmieniona.

Podczas korzystania z polecenia należy określić, jakie zmiany mają zostać wprowadzone. Na przykład, aby edytować tytuł, należy dodać go do treści żądania:

"title": "Tytuł nowego posta"

Wnioski

WordPress REST API to wielofunkcyjny interfejs, który umożliwia aplikacjom interakcję z witryną WordPress. Interfejs jest zarządzany za pomocą różnych poleceń, którym poświęciliśmy dzisiejszy artykuł. Mamy nadzieję, że te informacje były przydatne, dziękujemy za poświęcony czas!