Pravdepodobne ste už počuli o REST API. Možno ste už počuli, že používatelia WordPress z toho profitujú. Možno sa však pýtate, čo presne je WordPress API.
Pochopenie fungovania API nie je také zložité, ako to znie. Pokračujte v čítaní, aby ste sa dozvedeli, čo je API, čo je REST API a ako môžete použiť WordPress REST API na svojich stránkach.
Čo je API?
Aplikačné programové rozhranie (API) je spôsob, ako môžu dve aplikácie „hovoriť“ medzi sebou. Jeden systém zadá požiadavku a druhý ju splní. Požiadavky, ktoré systém akceptuje, musia byť zahrnuté v API – inak nie je možné požiadavku splniť.
Myslite na to takto. Možno si naozaj hladný, tak pôjdeš do Waffle House. Objednáte si kávu, vajíčka a palacinky. Čašníčka začne zapisovať vašu objednávku – a keď sa dostanete k palacinkám, je zmätená. Waffle House nepodáva palacinky. Podávajú iba vafle.
Systém požadujúci palacinky z ponuky API, ktorá podáva iba vafle, zostane hladný.
Čo je REST API?
Keď hovoríme REST API, hovoríme o systéme obmedzení navrhnutých pre internet. Opisuje, ako môže jedna webová lokalita požadovať informácie z inej webovej lokality spôsobom, ktorý je škálovateľný a jednotný. REST znamená Representational State Transfer, ktorý definoval Roy Fielding v jeho doktorandská dizertačná práca.
Čo je to WordPress REST API?
Rozhranie WordPress REST API sa vzťahuje na požiadavky na webovú stránku spustenú na WordPress. Ak požadujeme zoznam príspevkov alebo stránok, môžeme očakávať, že tieto informácie dostaneme z WordPress REST API. WordPress nikdy neposkytne žiadne informácie, ktoré nie sú zverejnené, ako napríklad koncepty príspevkov alebo (čo je dôležitejšie) používateľské heslá.
Toto je základ pre Editor blokov, ktorý dynamicky vymieňa údaje s WordPress bez opätovného načítania stránky. Každý koncový bod vracia údaje vo formáte JSON, ktorý je čitateľný pomocou JavaScriptu – alebo v tomto prípade blokov.
Všimnite si, že REST API je len jedným z API poskytovaných WordPress. Existuje napríklad aj Database API a Metadata API, ktoré používajú pluginy na interakciu s WordPress na serveri. Môžete sa dozvedieť viac o WordPress API v Codex.
Ako funguje požiadavka WordPress REST API?
Existuje niekoľko základných častí REST API, konkrétne: trasy, koncové body, požiadavky a odpovede.
Trasy
Trasa je spôsob, akým odkazujeme na adresu URL, pomocou ktorej webová lokalita komunikuje. Bežná cesta vo WordPress je „/wp-admin“. Hoci to nie je cesta REST API, je to cesta, ktorú používa prehliadač na prístup k WordPress Admin Dashboard. Pre naše účely REST API trasy začínajú „/wp-json“ (pričom JSON je štandardný formát údajov).
Koncové body
Koncový bod je kombinácia trasy a typu prichádzajúcej požiadavky. Jedna trasa sa môže pripojiť k viacerým koncovým bodom, pretože existuje viacero typov požiadaviek. Bežné typy požiadaviek zahŕňajú GET (ako čítame dáta na trase) a POST (ako aktualizujeme dáta na trase).
Žiadosti a odpovede
Každá komunikácia s REST API je vložená medzi požiadavku a odpoveď. Jeden systém odošle požiadavku, na ktorú druhý systém odpovie. Rozhranie WordPress REST API obsahuje užitočné objekty pre doplnky na prístup k údajom požiadavky (WP_REST_Request) a správu údajov o odpovedi (WP_REST_Response), keď rozšírenie WordPress REST API.
Ako nainštalovať REST API vo WordPress
Od verzie WordPress 4.7 obsahuje WordPress rozhranie REST API ako základná vlastnosť.
Ak používate staršiu verziu, môžete nainštalovať json-rest-api doplnok funkcií. Toto bolo použité na vývoj REST API predtým, ako bolo plne integrované s kódovou základňou WordPress. Tento doplnok je technicky uzavretý, preto sa odporúča namiesto toho aktualizovať svoju verziu WordPress (alebo možno zvážiť spravovaný hosting WordPress a budete mať vždy aktuálne informácie.)
Príklady WordPress REST API
Pozrite sa na webovú stránku GiveWP. Ak ty prejdite na ich blog, budete môcť vidieť najnovšie správy a príspevky. Táto cesta vykresľuje HTML, čo je pekné na pohľad, ale pre programátora je ťažké s ním interagovať. Namiesto toho sú príspevky sprístupnené programátorom pomocou cesty „/wp-json/wp/v2/posts“.
Cesta „/wp-json/wp/v2/posts“ nám hovorí, že ide o zdroj WordPress („/wp“), že ide o verziu 2 („/v2/“) zdroja a konkrétne, že ide o príspevky („/príspevky“). Ak ste tak ešte neurobili, navštívte https://givewp.com/wp-json/wp/v2/posts a porovnajte s čím vidíte https://givewp.com/blog/. Dám vám nápovedu – je to tá istá informácia!
Ako príklad toho, ako sa REST API používa v rámci WordPress, zvážte blok posledných príspevkov. Ak chcete získať zoznam príspevkov vo WordPress, stránka by tradične musela odoslať požiadavku na server a potom znova vykresliť celú stránku.
Blok najnovších príspevkov si môže vyžiadať iba príspevky a potom sa znova vykresliť. Robí to pomocou REST API. A môže to urobiť viackrát, aby sa anketa o nové príspevky objavila – bez opätovného vykresľovania celej stránky. Toto je obzvlášť užitočné, keď uvažujete úplná úprava stránky v ktorých sa bloky používajú na úpravu a zobrazenie komponentov stránky.
Každý jednotlivý komponent si môže vyžiadať údaje, ktoré potrebuje (vrátane kontroly aktualizácií) a potom znova vykresliť len to, čo sa zmenilo.
Teraz viete
Teraz, keď ste pochopili účel a štruktúru WordPress REST API, pozrite sa, čo môžete nájsť sami. Úplný prehľad o používaní a rozšírení WordPress REST API nájdete na Príručka REST API.
Pamätajte: ak sa vás niekto opýta na API, nemôžete si objednať palacinky vo Waffle House.
Kým budete dolaďovať svoju stránku, nezabudnite, že skvelé stránky potrebujú skvelý hosting. To všetko získate so spravovaným WordPress od Hostinger. Vďaka vysokým rýchlostiam, možnostiam škálovateľnosti a vynikajúcej podpore sa môžete spoľahnúť na Hostinger, ktorý poháňa váš web WordPress.
Príďte sa pozrieť, prečo je v Hostinger zabudované lepšie. Pozrite si naše plány hostenia plne spravované WordPress ešte dnes.
