Prečo POUŽÍVAŤ REST API:
V tradičných webových aplikáciách, povedzme jednoduchý webový server PHP,
- Vyžiadate si stránku (povedzme php) zo servera.
- Server vyhľadá súbor skriptu (php), ktorá zodpovedá stránke, ktorú ste požadovali, a začne ju vykonávať. Skript sa pripojí k databáze, vyhľadá požadované informácie, umiestni informácie na stránku pekne naformátovaným spôsobom (zmiešaním kódu HTML + CSS + JavaScript s údajmi), ktorý vyzerá pre návštevníka veľmi atraktívne.
- Potom ho server odošle späť návštevníkovi.
V tomto modeli sa všetko spracovanie vykonáva na strane servera. Server musí teda urobiť viac práce. Údaje tu nie sú oddelené od stránky, sú vložené hlboko do stránky.
Ak si v budúcnosti budete chcieť na svojom webe vytvoriť aplikáciu pre Android alebo iOS alebo pre počítač, budete musieť urobiť oveľa viac práce. K databáze sa budete musieť pripojiť priamo z každej z týchto aplikácií, čo nemusí byť veľmi bezpečné. Čas vývoja sa predĺži a objavia sa problémy s prenosnosťou.
Povedzme, že ste na svojom webe úspešne vytvorili aplikácie pre počítače, Android a iOS. Celé meno používateľa je v každej z nich zobrazené malými písmenami. Teraz by ste to chceli zobraziť veľkými písmenami. Aby to mohli vývojári urobiť, musia osobitne upraviť verziu vašej aplikácie pre stolné počítače, systémy Android a iOS. Čo je časovo náročné. V skutočnom svete nebudú veci také jednoduché ako tento. Takže jedna verzia aplikácie (povedzme verzia pre počítač) môže mať v procese aktualizácie vážnu chybu. Oprava neskôr by zabrala viac času. Vidíte, ako sa zvyšuje doba vývoja? Toto riešenie nie je prenosné.
V rozhraní REST API sa servera API opýtate, čo potrebujete, a pošle vám iba informácie, ktoré požadujete, na serveri sa nerobí žiadne ďalšie formátovanie. Na serveri nie je potrebné zbytočné spracovanie. Výkon vášho webu a aplikácií sa teda prirodzene zvyšuje. Rovnaké údaje môžete použiť aj na svojom webe, v počítačoch, aplikáciách pre Android a iOS. Zmeny vykonané na serveroch sa prejavia v aplikáciách, ktoré používajú API. Skráti sa tiež čas a náklady na vývoj aplikácie.
Ako funguje REST API:
Rozhrania REST API majú koncové body. Koncový bod nie je nič iné ako adresa URL, ale v pekne formátovanom formáte a je zmysluplný. Používa natívne HTTP požiadavky (ako napr ZÍSKAJTE, POST, PUT, ODSTRÁNIŤ atď.), aby ste sa rozhodli, čo robiť, keď získate prístup ku každému koncovému bodu. O tých si ešte poviem.
Výstupným formátom rozhrania REST API je JSON tiež známy ako JavaScript Object Notation.
Príklad výstupu a ZÍSKAJTE žiadosť o REST API dňa / users / id / 12 koncový bod môže vyzerať takto:
„id“: 12,
"name": "David Smith",
"vek": 42,
"telefony": ["124-211-2341", "889-211-4545"],
"country": "USA"
Ako vidíte, urobil som a ZÍSKAJTE žiadosť dňa / users / id / 12 endpoint povedať REST API, aby mi poskytlo informácie o užívateľovi, ktorý má id 12. Dostal som iba informácie, ktoré som požadoval, nič viac, nič menej.
Teraz povedzme, že chcete informácie o posledných 10 používateľoch, ktorí sa zaregistrovali na vašom webe. Môžete urobiť ZÍSKAJTE žiadosť dňa / users / latest / 10 koncový bod.
Nové údaje na server môžete pridávať aj pomocou rozhrania REST API. Zvyčajne HTTP POST požiadavka sa používa na požiadanie rozhrania REST API o pridanie nových údajov na server API.
Môžete napríklad urobiť a POST žiadosť dňa / používateľov koncový bod s údajmi nového používateľa a budú pridané do databázy na vašom serveri API. Môžete tiež nakonfigurovať svoje API tak, aby vrátilo stav žiadosti.
"statusCode": 400,
"statusText": "Používateľ bol úspešne pridaný.„,
"data":
„id“: 13,
"name": "Mary Smith",
„vek“: 35,
"telefony": ["124-211-2341", "889-211-4545"],
"country": "USA"
Ako vidíte, statusCode a statusText Vlastnosť objektu JSON upozorní klienta API, že používateľ je úspešne pridaný. Pridané údaje sa tiež vrátia do súboru údaje vlastnosť objektu JSON. Svoje API si môžete nakonfigurovať tak, ako chcete.
Môžete tiež aktualizovať existujúci záznam z databázy servera API. The PUT HTTP požiadavka sa používa v koncovom bode API na aktualizáciu existujúcich údajov v databáze vášho servera API.
Povedzme napríklad, že chcete aktualizovať telefónne číslo používateľa s ID 13. Môžete urobiť PUT koncový bod API / user / id / 13.
"statusCode": 200,
"statusText": "Používateľ aktualizovaný.„,
"old_data":
„id“: 13,
"name": "Mary Smith",
„vek“: 35,
"telefony": ["124-211-2341", "889-211-4545"],
"country": "USA"
,
"new_data":
„id“: 13,
"name": "Mary Smith",
„vek“: 35,
"telefony": ["100-211-1111", "140-211-1145"],
"country": "USA"
Ako vidíte, aktualizácia je úspešná. Staré údaje a nové údaje sa vrátia do súboru old_data a new_data majetku objektu JSON.
Pomocou protokolu HTTP môžete tiež vymazať údaje z databázy servera API ODSTRÁNIŤ koncový bod API.
Napríklad ak chcete vymazať používateľa s ID 12, môžete urobiť a ODSTRÁNIŤ koncový bod API / user / id / 12.
"statusCode": 150,
"statusText": "Používateľ odstránený.„,
"data":
„id“: 12,
"name": "David Smith",
"vek": 42,
"telefony": ["124-211-2341", "889-211-4545"],
"country": "USA"
Ako vidíte, používateľ je odstránený a odstránené údaje používateľa sú vrátené v priečinku údaje vlastnosť objektu JSON.
Vysvetlil som štandardný spôsob použitia ZÍSKAJTE, POST, PUT a ODSTRÁNIŤ HTTP požiadavka na koncových bodoch API na vykonávanie operácie CRUD (vytváranie, čítanie, aktualizácia a mazanie) pomocou rozhrania REST API. Môžete však nakonfigurovať svoje API na vykonávanie určitých vecí na základe určitej požiadavky HTTP. Tu nie je nič opravené. API môžete napríklad aktualizovať pomocou ZÍSKAJTE HTTP požiadavka. Nemusíte používať PUT. Je to na návrhárovi API.
Navrhujete aj koncové body API. Ak svojim koncovým bodom API dáte zmysluplné názvy, bude sa vaše REST API oveľa jednoduchšie používať.
Aplikácie REST API:
Rozhrania API uľahčujú a modifikujú vývoj aplikácií. Pomocou REST API môžete svoju aplikáciu ľahko preniesť na rôzne platformy.
Musíte len navrhnúť a vyvinúť REST API vašej aplikácie. Potom môžete použiť svoje REST API z vášho webu, aplikácie pre Android, aplikácie pre iOS, desktopovej aplikácie pre Windows a aplikácie pre Linux atď. Týmto spôsobom budú všetky vaše aplikácie na inej platforme používať rovnakú logiku a zníži sa váš čas a náklady na vývoj. Aplikácie sa tiež budú ľahšie spravovať. Rozhrania REST API sa v dnešnej dobe rýchlo využívajú aj v jednostránkových webových aplikáciách.
Napísal som článok o písaní rozhraní REST API pomocou jazyka Python. Ďakujeme, že ste si prečítali tento článok.