WordPress REST API: Co to je a jak začít používat

Pokud jste během posledních několika let v komunitě WordPress strávili nějaký čas, je pravděpodobné, že jste slyšeli odkaz na nové rozhraní REST API. Pokud však nejste zkušeným vývojářem, možná nemáte tušení, co vlastně je rozhraní WordPress REST API.


Zatímco technické detaily jsou trochu složitější, základní koncepce této funkce jsou dostatečně snadno pochopitelné. Nové API pomáhá rozšířit to, co WordPress jako platforma dokáže. A co víc, rozhraní REST API usnadňuje vývojářům připojení WordPress k jiným webům a aplikacím.

WordPress REST API

V tomto podrobném průvodci vás provedeme všemi základy, které potřebujete znát. Vysvětlíme, co jsou API obecně a jaká jsou REST API (a verze specifická pro WordPress). Poté si povíme, jak začít sami používat rozhraní WordPress REST API. Pojďme přímo dovnitř!

Úvod do aplikačních programovacích rozhraní (API)

Než se ponoříme do REST API konkrétně, vraťme se trochu zpět. Abychom porozuměli tomuto konceptu, je nejprve důležité mít základní představu o tom, co API jsou obecně.

Na své nejzákladnější úrovni, rozhraní API nebo aplikačního programování – umožňuje vzájemné komunikaci dvou aplikací. Když například navštívíte web, prohlížeč odešle požadavek na server, na kterém je tento web umístěn. Rozhraní API tohoto serveru je to, co obdrží váš prohlížeč, interpretuje jej a odešle zpět všechna data potřebná k zobrazení vašeho webu.

Je toho mnohem víc způsob práce API v technickém smyslu, samozřejmě. Zaměříme se však na to, co je pro vás nejdůležitější – praktické aplikace. Rozhraní API získávají velkou pozornost a viditelnost, protože mnoho společností je začalo balit a poskytovat je jako produkty, které můžete použít.

Jinými slovy, vývojáři ve společnosti, jako je Google, budou shromažďovat některé části kódu své aplikace společně a zveřejnit je. Ostatní vývojáři tak mohou rozhraní API používat jako nástroj, který jim pomůže připojit se ke svým webům a využívat jeho funkcí:

Knihovna API společnosti Google.

Například můžete použít API Map Google umístit plně funkční mapu na vašem webu, který těží ze všech relevantních dat a funkcí Google. To vám ušetří nutnost kódování mapy a sebrání všech těchto dat. Totéž platí pro širokou škálu webů a aplikací.

S tím, jak se webové stránky a funkce, na které se spoléhají, stávají složitějšími, se stávají klíčové nástroje jako API. Umožňují vývojářům stavět na stávajících funkcích a umožňují jednoduše „připojit“ nové funkce na váš web. Web, který vlastní API, zase těží ze zvýšené expozice a provozu.

Základní pravidla API REST (Reprezentativní státní převod)

Existuje mnoho způsobů, jak vytvořit API. A REST (Representational State Transfer) API je konkrétní typ, který je vyvíjen podle specifických pravidel. Jinými slovy, REST představuje řadu pokynů, které mohou vývojáři použít při vytváření API. Tím je zajištěno, že API fungují efektivně.

Abyste pochopili, jak funguje rozhraní REST API, musíte vědět, jaká pravidla (nebo „omezení“) fungují. Existují pět základních prvků které vytvářejí API „RESTful“. Mějte na paměti, že „server“ je platforma, do které API patří, a „klient“ je web, aplikace nebo software připojující se k této platformě:

Klidný

  1. Architektura klient-server. Rozhraní API by mělo být vytvořeno tak, aby klient a server zůstali navzájem odděleni. Tímto způsobem se mohou dále rozvíjet samy a mohou být použity samostatně.
  2. Bez státní příslušnosti. REST API musí dodržovat protokol „bez státní příslušnosti“. Jinými slovy, nemohou na serveru ukládat žádné informace o klientovi. Požadavek klienta by měl zahrnovat všechna potřebná data předem a odpověď by měla poskytnout vše, co klient potřebuje. Díky tomu je každá interakce „jednorázová a hotová“, což snižuje nároky na paměť i možnost chyb.
  3. Odpojitelnost. „Mezipaměť“ je dočasné uložení konkrétních dat, takže je lze načíst a odeslat rychleji. RESTful API využívají data, která lze ukládat do mezipaměti, kdykoli je to možné, aby se zvýšila rychlost a efektivita. Kromě toho musí API informovat klienta, zda je možné a mělo by být ukládáno do mezipaměti každý kus dat.
  4. Vrstvený systém. Správně navržená rozhraní REST API jsou vytvořena pomocí vrstev, z nichž každá má svou vlastní určenou funkci. Tyto vrstvy interagují, ale zůstávají oddělené. Tím se API snadněji modifikuje a aktualizuje v průběhu času a také zvyšuje jeho bezpečnost.
  5. Jednotné rozhraní. Všechny části rozhraní REST API musí fungovat přes stejné rozhraní a komunikovat pomocí stejných jazyků. Toto rozhraní by mělo být navrženo speciálně pro API a mělo by se vyvíjet samostatně. Funkce by neměla záviset na serveru nebo klientovi.

Jakékoli API, které dodržuje tyto zásady, lze považovat za RESTful. Existuje také šesté omezení, označované jako „kód na vyžádání“. Při dodržení této techniky umožňuje rozhraní API pokyn serveru k přenosu kódu klientovi, aby se rozšířila jeho funkčnost. Toto omezení je však volitelné a není přijato všemi rozhraními REST API.

WordPress REST API

V tuto chvíli možná přemýšlíte, jak to všechno ovlivňuje vás. API jsou vynikajícími nástroji, ale jsou relevantní pro vaši každodenní práci? Pokud jste uživatelem WordPress, odpověď je jednoznačná "Ano".

WordPress REST API se vyvíjí již několik let. Na chvilku to fungovalo jako nezávislý plugin, které vývojáři mohli časem přispět, bylo k dispozici každému, s kým experimentovat.

Ve skutečnosti ano dvě oddělené verze pluginu REST API. Prvky API byly přidány do základní platformy již v aktualizaci 4.4. Následně se stala plně integrovanou od WordPress 4.7 (v roce 2016). To znamená, že dnes má WordPress vlastní plně funkční REST API.

Proč se platforma posunula? Podle místo projektu sám, je to proto, že WordPress směřuje k tomu, aby se stal "plně funkční aplikační rámec". Jinými slovy, REST API umožňuje platformě komunikovat s téměř jakýmkoli webem a webovou aplikací. Navíc může komunikovat a vyměňovat si data bez ohledu na to, jaké jazyky používá externí program.

zbytek api

To vývojářům otevírá řadu možností. Díky tomu je WordPress jako platforma flexibilnější a univerzálnější než kdy jindy. Jako Katie Keith, provozní ředitelka společnosti Barn2 Media říká to:

Po pochopení REST API si vývojáři WordPressu mohou vybrat nejefektivnější způsob implementace každé úlohy, aniž by se omezili na konkrétní technologie nebo platformy, jako je PHP nebo zadní konec WordPress. REST API, které se používá efektivně, usnadňuje integraci třetích stran … Dokonce otevírá nové příležitosti, například pro vytváření vlastních mobilních aplikací založených na WordPress, nebo objevuje nové a jedinečné způsoby komunikace s WordPress.

Je také důležité si uvědomit, že tato funkce může být někdy označována jako rozhraní WordPress JSON REST API. Část „JSON“, což je zkratka pro JavaScript Object Notation, popisuje formát, který API používá pro výměnu dat. Tento formát je založen na JavaScriptu a je oblíbeným způsobem vývoje API díky tomu, jak dobře se propojuje s mnoha běžnými programovacími jazyky. Jinými slovy, JSON API je schopno snáze usnadnit komunikaci mezi aplikacemi, které používají různé jazyky.

Anatomie požadavku WordPress REST API

Nyní byste měli rozumět celkovému účelu a směru rozhraní API WordPress REST. Proto se pojďme podívat na několik specifik o tom, jak to funguje. Existuje několik základních konceptů, které musíte pochopit, pokud se chcete seznámit a začít experimentovat s API sami.

Jak jsme vysvětlili, každé API zpracovává požadavky a vrací odpovědi. Jinými slovy klient požádá o provedení určité akce a API tuto akci provede. Přesně to se API mohou lišit. REST API jsou speciálně navržena tak, aby přijímala a odpovídala na konkrétní typ požadavků, pomocí jednoduchých příkazů HTML (nebo „metod“).

Pro ilustraci zde uvádíme nejvíce základní a důležité metody HTML klient může poslat:

HTML metody

  • DOSTAT: Tento příkaz načte zdroj ze serveru (například konkrétní část dat).
  • POŠTA: Tím klient přidá zdroj na server.
  • DÁT: Můžete použít k úpravě nebo aktualizaci zdroje, který je již na serveru.
  • ODSTRANIT: Jak název napovídá, odebere se zdroj ze serveru.

Spolu s těmito příkazy klient pošle jeden nebo více řádků, které přesně komunikují, který zdroj je požadovaný a co by s ním mělo být provedeno. Například požadavek na nahrání souboru PHP do konkrétní složky na serveru může vypadat takto:

POST /foldername/my_file.php

Část /foldername/my_file.php je nazývána „cesta“, protože řekne API, kam má jít a s jakými daty má interagovat. Když ji zkombinujete s metodou HTTP (v tomto případě POST), bude celá funkce označována jako „koncový bod“.

Většina rozhraní REST API a klientů, kteří s nimi komunikují, je mnohem komplikovanější než tato – včetně verze WordPress. Tyto základní prvky však tvoří základ pro fungování rozhraní API WordPress REST.

Jak začít používat rozhraní WordPress REST API

Pokud máte nastavený web WordPress, můžete začít experimentovat s REST API hned. Můžete přímo provádět různé požadavky GET a získávat data jednoduše pomocí prohlížeče.

Chcete-li získat přístup k rozhraní API WordPress REST, musíte začít následující cestou:

yoursite.com/wp-json/wp/v2

Poté můžete na tuto adresu URL přidat různé typy dat. Například můžete vyhledat konkrétní uživatelský profil cestou, jako je tato:

yoursite.com/wp-json/wp/v2/users/4567

V tomto scénáři, "4567" je jedinečné ID uživatele pro profil, který chcete vidět. Pokud jste toto ID vynechali, místo toho by se vám zobrazil seznam všech uživatelů na vašem webu:

Seznam uživatelů v rozhraní WordPress REST API.

Stejnou základní trasu můžete použít k zobrazení dalších typů dat, jako jsou vaše příspěvky nebo stránky. Můžete dokonce vyhledávat podmnožiny dat, která splňují určitá kritéria. Pomocí této adresy URL byste například mohli získat všechny příspěvky, které obsahují konkrétní výraz:

yoursite.com/wp-json/wp/v2/posts?=search[keyword]

Toto je samozřejmě pouze jednoduchá ilustrace. To, co ve skutečnosti můžete dělat pomocí rozhraní API WordPress REST, není téměř žádné. Pokud se chcete dozvědět více o tom, jak to funguje, doporučujeme začít s následujícími zdroji:

WordPress REST API je bezpochyby složité téma. I pro nerozvinuté vývojáře však stojí za to porozumět základům toho, jak tato technologie funguje a co to umožňuje. A co víc, může vám to dokonce umožnit začít fušovat ve vývoji sami!

Ještě jeden přístup k používání rozhraní WordPress REST API

WordPress REST API lze použít pro řadu zajímavých věcí a projektů. Zjistili jsme to jasně.

Existuje však jedna oblast, kde získává skutečnou popularitu:

Bezhlavé WordPress je myšlenka oddělení dvou hlavních vrstev ekosystému WordPress – backend a frontend.

To vám umožní vzít si vše dobré, co má software WordPress pod kapotou, a spojit je s konečným produktem, který nepoužívá standardní prezentaci WordPress – nejedná se o web, sám o sobě.

Celý koncept je velmi zajímavý. Hovoříme o tom ještě v jiném příspěvku, kde diskutujeme o tom, zda bezhlavý WordPress dává smysl, a porovnáme špičková hostingová řešení WordPress na trhu..

Závěr

Není lepší čas se dozvědět o rozhraní WordPress REST API než nyní. Vzhledem k tomu, že byl plně začleněn do jádra WordPress, bude hrát v budoucnosti platformy důležitou roli. Vývojáři všech pruhů budou používat toto API pro připojení WordPress k širšímu webu způsobem, který byl dříve obtížný nebo nemožný.

Pochopení tohoto konceptu pro sebe může být trochu náročné. Na základní úrovni jsou však koncepty dostatečně snadno pochopitelné. REST API je rozhraní, které umožňuje dvěma programům „mluvit“ navzájem a je vytvořeno následující pokyny které zajišťují, že je flexibilní, rozšiřitelný a bezpečný. Pokud se chcete podrobněji seznámit s tím, jak to všechno funguje a jak se dá použít, existuje spousta užitečných zdrojů, například oficiální příručka.

Máte nějaké dotazy ohledně rozhraní REST API a co to znamená pro WordPress? Zeptejte se nás v sekci komentářů níže!

Nezapomeňte se připojit k našemu havarijnímu kurzu při urychlení vašeho webu WordPress. Pomocí několika jednoduchých oprav můžete zkrátit dobu načítání až o 50–80%:

Jeffrey Wilson Administrator
Sorry! The Author has not filled his profile.
follow me
    Like this post? Please share to your friends:
    Adblock
    detector
    map