{"id":52101,"date":"2022-10-20T14:06:02","date_gmt":"2022-10-20T21:06:02","guid":{"rendered":"https:\/\/dhblog.dream.press\/blog\/?p=52101"},"modified":"2025-05-26T11:42:52","modified_gmt":"2025-05-26T18:42:52","slug":"samouczek-wp-rest-api","status":"publish","type":"post","link":"https:\/\/www-dev.dreamhost.com\/blog\/pl\/samouczek-wp-rest-api\/","title":{"rendered":"Wprowadzenie do WordPress REST API"},"content":{"rendered":"\n

Kiedy REST API zosta\u0142o w ko\u0144cu dodane do rdzenia WordPress<\/a>, by\u0142 to koniec d\u0142ugiej podr\u00f3\u017cy. Wielu oczekiwa\u0142o tej zmiany jako najwi\u0119kszego kroku naprz\u00f3d dla WordPress w historii platformy. Jednak\u017ce, je\u015bli nie jeste\u015b zaznajomiony z REST API, mo\u017cesz by\u0107 zdezorientowany, co to wszystko oznacza.<\/p>\n\n\n\n

W skr\u00f3cie, dodanie WordPress REST API<\/a> przekszta\u0142ci\u0142o WordPressa w w pe\u0142ni funkcjonalny framework aplikacyjny. To znacz\u0105co zwi\u0119kszy\u0142o jego \u201erozszerzalno\u015b\u0107\u201d, czyli zdolno\u015b\u0107 do rozszerzania o nowe funkcje i mo\u017cliwo\u015bci. Ponadto rozszerzy\u0142o potencja\u0142 platformy do komunikacji z innymi stronami i aplikacjami.<\/p>\n\n\n\n

Wprowadzenie do REST API<\/b><\/h2>\n\n\n\n

Zanim zag\u0142\u0119bimy si\u0119 w WordPress REST API, wa\u017cne jest, aby\u015bmy wyja\u015bnili nasz\u0105 terminologi\u0119. Jest to temat, w kt\u00f3rym b\u0119dziemy musieli u\u017cy\u0107 wielu skr\u00f3t\u00f3w, wi\u0119c wyja\u015bnijmy je na pocz\u0105tku.<\/p>\n\n\n\n

Przede wszystkim musisz wiedzie\u0107, czym s\u0105 Application Programming Interfaces (APIs)<\/a>. W najprostszych terminach, API to \u015brodek, dzi\u0119ki kt\u00f3remu jeden system umo\u017cliwia innym systemom dost\u0119p do swoich danych.<\/p>\n\n\n\n

Na przyk\u0142ad, gdy strona internetowa dodaje przycisk polubienia Facebooka na swojej stronie, robi to poprzez po\u0142\u0105czenie z API Facebooka. Pozwala to stronie internetowej u\u017cywa\u0107 API do odbierania danych (kod przycisku polubienia) i wysy\u0142ania danych (\u017c\u0105danie polubienia).<\/p>\n\n\n\n

Wi\u0119c, czym dok\u0142adnie jest REST API? Representational State Transfer (REST)<\/a> to typ API specyficzny dla us\u0142ug internetowych. Zawiera on standardowy zestaw instrukcji i zasad, co u\u0142atwia wszystkim us\u0142ugom ‘RESTful’ wzajemne po\u0142\u0105czenie.<\/p>\n\n\n\n

W skr\u00f3cie, REST APIs umo\u017cliwiaj\u0105 wysy\u0142anie \u017c\u0105da\u0144 do zewn\u0119trznego systemu. Przyk\u0142adem mo\u017ce by\u0107 Twitter. Mo\u017cesz u\u017cy\u0107 jego API, aby za\u017c\u0105da\u0107 okre\u015blonej liczby tweet\u00f3w od konkretnego u\u017cytkownika. API nast\u0119pnie zwr\u00f3ci tweety zgodnie z twoim \u017c\u0105daniem, kt\u00f3re mo\u017cesz osadzi\u0107 na swojej stronie za pomoc\u0105 HTML<\/a> i CSS<\/a>.<\/p>\n\n\n\n

Te \u017c\u0105dania s\u0105 realizowane za pomoc\u0105 JavaScript Object Notation (JSON)<\/a>. Jest to j\u0119zyk specjalnie zaprojektowany do wysy\u0142ania, odbierania i przechowywania danych.<\/p>\n\n\n\n

Zajmiemy si\u0119 JSON p\u00f3\u017aniej w tym artykule, ale zalecamy po\u015bwi\u0119ci\u0107 troch\u0119 czasu, aby zapozna\u0107 si\u0119 z tym j\u0119zykiem z g\u00f3ry. Pomo\u017ce to przygotowa\u0107 si\u0119 do korzystania z WordPress REST API oraz zrozumienia niekt\u00f3rych koncepcji, o kt\u00f3rych b\u0119dziemy rozmawia\u0107.<\/p>\n\n\n\n

Co to jest WordPress REST API (i dlaczego jest wa\u017cne)<\/b><\/h2>\n\n\n
\n
\"WordPress<\/figure><\/div>\n\n\n

WordPress REST API<\/a> dzia\u0142a w du\u017cej mierze tak samo, jak przyk\u0142ady, kt\u00f3re ju\u017c om\u00f3wili\u015bmy. Zasadniczo, WordPress REST API daje ci pe\u0142ny dost\u0119p do funkcji WordPressa z dowolnego frameworka kompatybilnego z JSON.<\/p>\n\n\n\n

Podobnie jak API Twittera umo\u017cliwia pobieranie i wysy\u0142anie tweet\u00f3w, WordPress REST API mo\u017ce by\u0107 u\u017cywane do zarz\u0105dzania postami, u\u017cytkownikami, kategoriami i wieloma innymi elementami z zewn\u0119trznych platform. Pozwala to na wykorzystanie WordPressa w wielu dot\u0105d nieosi\u0105galnych spos\u00f3bach.<\/p>\n\n\n\n

API REST zosta\u0142o og\u0142oszone<\/a> ju\u017c w 2013 roku. Pocz\u0105tkowo by\u0142o dodatkiem<\/a>, kt\u00f3ry mia\u0142 zosta\u0107 w\u0142\u0105czony do rdzenia WordPressa w wersji 4.1. Jak to cz\u0119sto bywa, op\u00f3\u017anienia przesun\u0119\u0142y dat\u0119 wydania a\u017c do ostatecznego wdro\u017cenia do rdzenia z wydaniem WordPress 4.7<\/a> trzy lata p\u00f3\u017aniej.<\/p>\n\n\n\n

To by\u0142a d\u0142uga, ale warta czekania chwila dla wielu os\u00f3b, kt\u00f3re uwa\u017ca\u0142y WordPress REST API za wa\u017cny krok naprz\u00f3d dla platformy. Mo\u017cesz si\u0119 zastanawia\u0107, dlaczego to dodanie by\u0142o tak wa\u017cne, szczeg\u00f3lnie \u017ce wielu u\u017cytkownik\u00f3w prawdopodobnie nie zauwa\u017cy\u0142o du\u017cego znaczenia. Jak si\u0119 okazuje, w\u0142\u0105czenie REST API by\u0142o fundamentaln\u0105 zmian\u0105 dla WordPressa z wielu powod\u00f3w.<\/p>\n\n\n\n

Wprowadzaj\u0105c REST API, WordPress przeszed\u0142 od bycia tylko platform\u0105 do tworzenia stron internetowych do pe\u0142noprawnego frameworku aplikacyjnego. Oznacza to, \u017ce deweloperzy mog\u0105 wykorzysta\u0107 stron\u0119 WordPress do tworzenia aplikacji na urz\u0105dzenia mobilne i sieciowe lub jako repozytorium informacji.<\/p>\n\n\n\n

Ta zmiana umo\u017cliwi\u0142a r\u00f3wnie\u017c WordPressowi oddalenie si\u0119 od zale\u017cno\u015bci od PHP<\/a>. Dzi\u0119ki sprawieniu, \u017ce WordPress jest kompatybilny z dowolnym j\u0119zykiem kompatybilnym z JSON, REST API znacznie rozszerzy\u0142o mo\u017cliwo\u015bci dla programist\u00f3w, umo\u017cliwiaj\u0105c im korzystanie z funkcjonalno\u015bci WordPressa z praktycznie dowolnym frameworkiem.<\/p>\n\n\n\n

Ostatecznie, REST API zapewnia wi\u0119ksz\u0105 elastyczno\u015b\u0107 interfejs\u00f3w, z kt\u00f3rych mo\u017cna korzysta\u0107 przy pracy z platform\u0105. Sprawi\u0142o to, \u017ce interfejs administracyjny sta\u0142 si\u0119 ca\u0142kowicie opcjonalny, poniewa\u017c teraz mo\u017cna w pe\u0142ni oddzia\u0142ywa\u0107 na swoj\u0105 stron\u0119 WordPress za pomoc\u0105 polece\u0144 JSON.<\/p>\n\n\n\n

Teraz przyjrzyjmy si\u0119, jak JSON i REST API wsp\u00f3\u0142pracuj\u0105, aby to umo\u017cliwi\u0107.<\/p>\n\n\n\n

Jak REST API i JSON dzia\u0142aj\u0105 razem<\/b><\/h2>\n\n\n\n

Do tej pory powiniene\u015b mie\u0107 poj\u0119cie o teoretycznych aspektach WordPress REST API. Wi\u0119c, przyjrzyjmy si\u0119 bardziej praktycznej stronie tej technologii. Oficjalny podr\u0119cznik<\/a> opisuje korzystanie z REST API w nast\u0119puj\u0105cy spos\u00f3b:<\/p>\n\n\n\n

\u201eAPI REST WordPress zapewnia punkty ko\u0144cowe API dla typ\u00f3w danych WordPress, kt\u00f3re pozwalaj\u0105 programistom na zdaln\u0105 interakcj\u0119 z witrynami, poprzez wysy\u0142anie i odbieranie obiekt\u00f3w JSON (JavaScript Object Notation).\u201d<\/p>\n\n\n\n

Pierwszym s\u0142owem, na kt\u00f3rym musimy si\u0119 skupi\u0107, jest \u201eendpoints\u201d. Najprostszym sposobem na zrozumienie, czym jest endpoint, jest potraktowanie go jako fragmentu danych lub funkcji, kt\u00f3re mo\u017cna wywo\u0142a\u0107 za pomoc\u0105 \u017c\u0105dania JSON<\/a>. Domy\u015blnie WordPress oferuje ogromn\u0105 liczb\u0119 standardowych endpoint\u00f3w<\/a> do wykorzystania, ale programi\u015bci mog\u0105 r\u00f3wnie\u017c tworzy\u0107 niestandardowe endpointy<\/a>.<\/p>\n\n\n\n

Aby dotrze\u0107 do punktu ko\u0144cowego, musisz u\u017cy\u0107 ‘trasy’,<\/a> kt\u00f3ra przyjmuje form\u0119 normalnego URL. Mo\u017cesz nawet spr\u00f3bowa\u0107 tego teraz samodzielnie.<\/p>\n\n\n\n

Przejd\u017a do swojej w\u0142asnej strony WordPress i dodaj \/wp-json\/wp\/v2<\/i> na ko\u0144cu jej adresu URL. Je\u015bli Twoja strona to http:\/\/example.com<\/i>, wprowad\u017a http:\/\/example.com\/wp-json\/wp\/v2<\/i>.<\/p>\n\n\n\n

Kiedy za\u0142adujesz t\u0119 tras\u0119, dotrzesz do punktu ko\u0144cowego, kt\u00f3ry w tym przypadku zwraca ca\u0142\u0105 zawarto\u015b\u0107 i metadane dla Twojej strony w (nieuporz\u0105dkowanym) formacie JSON. Korzystaj\u0105c z r\u00f3\u017cnych tras, mo\u017cesz uzyska\u0107 dost\u0119p do r\u00f3\u017cnych punkt\u00f3w ko\u0144cowych, aby uzyska\u0107 konkretne typy informacji i wykonywa\u0107 r\u00f3\u017cne zadania.<\/p>\n\n\n\n

Istniej\u0105 trzy g\u0142\u00f3wne \u017c\u0105dania JSON<\/a>, kt\u00f3rych b\u0119dziesz u\u017cywa\u0107 z REST API, wi\u0119c rzu\u0107my na nie teraz szybkie spojrzenie. S\u0105 to:<\/p>\n\n\n\n