Phenquestions
Proč POUŽÍT REST API:
V tradičních webových aplikacích, řekněme jednoduchý webový server PHP,
- Vyžádáte si stránku (řekněme php) ze serveru.
- Server najde soubor skriptu (php) odpovídající stránce, kterou jste požadovali, a začne ji spouštět. Skript se připojí k databázi, vyhledá požadované informace, umístí informace na stránku pěkně formátovaným způsobem (smícháním HTML + CSS + JavaScript s daty), který pro návštěvníka vypadá velmi atraktivně.
- Poté jej server odešle zpět návštěvníkovi.
V tomto modelu se veškeré zpracování provádí na straně serveru. Server tedy musí udělat více práce. Data zde nejsou oddělená od stránky, jsou vložena hluboko do stránky.
Pokud si v budoucnu budete chtít na svém webu vytvořit aplikaci pro Android nebo iOS nebo pro stolní počítače, budete muset udělat mnohem více práce. K databázi se budete muset připojit přímo z každé z těchto aplikací, což nemusí být příliš bezpečné. Doba vývoje se zvýší a objeví se problémy s přenositelností.
Řekněme, že jste na svém webu úspěšně vytvořili aplikace pro stolní počítače, Android a iOS. Celé jméno uživatele je v každém z nich zobrazeno malými písmeny. Nyní byste to chtěli ukázat velkými písmeny. Aby to mohli vývojáři udělat, musí samostatně upravit verzi vaší aplikace pro stolní počítače, Android a iOS. Což je časově náročné. Ve skutečném světě to nebude tak jednoduché jako v tomto. Jedna verze aplikace (řekněme verze pro stolní počítače) tedy může mít v procesu aktualizace vážnou chybu. Oprava později by zabrala více času. Vidíte, jak se doba vývoje prodlužuje? Toto řešení není také přenosné.
V REST API se zeptáte serveru API, co potřebujete, a pošle vám pouze informace, které požadujete, na serveru se neprovádí žádné další formátování. Na serveru není nutné zbytečné zpracování. Výkon vašeho webu a aplikací se tedy přirozeně zlepšuje. Stejná data můžete také použít na svém webu, v desktopové aplikaci, v aplikacích pro Android a iOS. Změny provedené na serverech se projeví v aplikacích, které používají API. Zkrátí se také čas a náklady na vývoj aplikace.
Jak funguje REST API:
Rozhraní REST API mají koncové body. Koncový bod není nic jiného než adresa URL, ale v pěkně naformátovaném způsobem a má smysl. Používá nativní požadavky HTTP (například DOSTAT, POŠTA, DÁT, VYMAZAT atd.), abyste se rozhodli, co dělat, když přistupujete ke každému koncovému bodu. O těch si promluvím později.
Výstupním formátem REST API je JSON, známý také jako JavaScript Object Notation.
Příklad výstupu a DOSTAT požadavek na REST API dne / users / id / 12 koncový bod může vypadat takto:
"id": 12,
"name": "David Smith",
"age": 42,
"telefony": ["124-211-2341", "889-211-4545"],
"country": "US"
Jak vidíte, udělal jsem DOSTAT požadavek na / users / id / 12 endpoint říct REST API, aby mi dal informace o uživateli, který má id 12. Dostal jsem jen informace, které jsem požadoval, nic víc, nic méně.
Řekněme, že chcete informace o posledních 10 uživatelích, kteří se zaregistrovali na vašem webu. Můžete udělat DOSTAT požadavek na / users / latest / 10 koncový bod.
Můžete také přidat nová data na svůj server pomocí REST API. Obvykle HTTP POŠTA požadavek se používá k požádání rozhraní REST API o přidání nových dat na server API.
Můžete například udělat a POŠTA požadavek na / uživatelé koncový bod s daty nového uživatele a budou přidány do databáze na vašem serveru API. Můžete také nakonfigurovat své API tak, aby vrátilo stav požadavku.
"statusCode": 400,
"statusText": "Uživatel byl úspěšně přidán.",
"data":
"id": 13,
"name": "Mary Smith",
"age": 35,
"telefony": ["124-211-2341", "889-211-4545"],
"country": "US"
Jak vidíte, statusCode a statusText vlastnost objektu JSON upozorní klienta API, že je uživatel úspěšně přidán. Přidaná data se vrací také v data vlastnost objektu JSON. Rozhraní API můžete nakonfigurovat tak, jak chcete.
Můžete také aktualizovat existující záznam z databáze serveru API. The DÁT Požadavek HTTP se používá v koncovém bodu API k aktualizaci stávajících dat v databázi vašeho serveru API.
Řekněme například, že chcete aktualizovat telefonní číslo uživatele s ID 13. Můžete udělat DÁT požadavek na koncový bod API / user / id / 13.
"statusCode": 200,
"statusText": "Uživatel aktualizován.",
"old_data":
"id": 13,
"name": "Mary Smith",
"age": 35,
"telefony": ["124-211-2341", "889-211-4545"],
"country": "US"
,
"new_data":
"id": 13,
"name": "Mary Smith",
"age": 35,
"telefony": ["100-211-1111", "140-211-1145"],
"country": "US"
Jak vidíte, operace aktualizace je úspěšná. Stará data a nová data se vrací do old_data a new_data vlastnost objektu JSON.
Pomocí protokolu HTTP můžete také odstranit data z databáze serveru API VYMAZAT požadavek na koncový bod API.
Chcete-li například odstranit uživatele s ID 12, můžete udělat a VYMAZAT požadavek na koncový bod API / user / id / 12.
"statusCode": 150,
"statusText": "Uživatel odstraněn.",
"data":
"id": 12,
"name": "David Smith",
"age": 42,
"telefony": ["124-211-2341", "889-211-4545"],
"country": "US"
Jak vidíte, uživatel je odstraněn a odstraněná uživatelská data jsou vrácena v data vlastnost objektu JSON.
Vysvětlil jsem standardní způsob použití DOSTAT, POŠTA, DÁT a VYMAZAT Požadavek HTTP na koncové body API k provádění operací CRUD (vytváření, čtení, aktualizace a mazání) pomocí rozhraní REST API. Ale můžete nakonfigurovat své API tak, aby na určitý požadavek HTTP dělalo určité věci. Nic zde není opraveno. Například můžete aktualizovat API pomocí DOSTAT HTTP požadavek. Nemusíte používat DÁT. Je to na návrháři API.
Navrhujete také koncové body API. Když svým koncovým bodům API přidáte smysluplné názvy, bude vaše REST API mnohem jednodušší.
Aplikace REST API:
Díky API je vývoj aplikací jednodušší a modulární. S pomocí REST API můžete snadno přenést svou aplikaci na různé platformy.
Musíte jen navrhnout a vyvinout REST API vaší aplikace. Pak můžete použít REST API z vašeho webu, aplikace pro Android, aplikace pro iOS, desktopové aplikace pro Windows a aplikace pro Linux atd. Tímto způsobem budou všechny vaše aplikace na jiné platformě používat stejnou logiku a sníží se čas a náklady na vývoj. Aplikace se také budou snáze spravovat. Rozhraní REST API se v dnešní době také rychle používají v jednostránkových webových aplikacích.
Napsal jsem článek o psaní REST API pomocí Pythonu. Děkujeme za přečtení tohoto článku.
