Phenquestions
Защо да използваме REST API:
В традиционните уеб приложения, да кажем, обикновен PHP уеб сървър,
- Искате страница (да кажем php) от сървъра.
- Сървърът намира файла на скрипта (php), съответстваща на страницата, която сте поискали, и започва да я изпълнява. Скриптът се свързва с базата данни, търси необходимата информация, поставя информацията в страницата по добре форматиран начин (смесване на HTML + CSS + JavaScript с данните), което изглежда много привлекателно за посетителя.
- След това сървърът го изпраща обратно на посетителя.
В този модел цялата обработка се извършва от страна на сървъра. Така че сървърът трябва да свърши повече работа. Тук данните не са отделни от страницата, те са вградени дълбоко в страницата.
Ако в бъдеще искате да направите приложение за Android или приложение за iOS или настолно приложение на уебсайта си, ще трябва да свършите много повече работа. Ще трябва да се свържете с базата данни директно от всяко от тези приложения, което може да не е много сигурно. Времето за разработка ще се увеличи и ще възникнат проблеми с преносимостта.
Да приемем, че успешно сте направили приложения за настолни компютри, Android и iOS на вашия уебсайт. Пълното име на потребителя се показва с малки букви във всеки от тях. Сега бихте искали да го покажете с главни букви. Е, разработчиците трябва да модифицират версията на приложението си за настолни компютри, Android и iOS отделно, за да направят това. Което отнема много време. В реалния свят нещата няма да бъдат толкова прости, колкото този. И така, една версия на приложението (да речем версията на работния плот) може да има сериозна грешка в процеса на обновяване. Поправянето му по-късно ще отнеме повече време. Можете ли да видите как се увеличава времето за разработка? Това решение също не е преносимо.
В REST API вие питате API сървъра от какво се нуждаете и той ви изпраща само информацията, която искате, не се прави допълнително форматиране в сървъра. Няма нужда от ненужна обработка в сървъра. Така че, ефективността на вашия уебсайт и приложения естествено се подобрява. Също така можете да използвате същите данни във вашия уебсайт, настолно приложение, приложения за Android и iOS. Промените, направени в сървърите, ще бъдат отразени в приложенията, които използват API. Времето и разходите за разработка на приложението също ще бъдат намалени.
Как работи REST API:
API-тата REST имат крайни точки. Крайната точка не е нищо повече от URL, но по добре форматиран начин и има смисъл. Той използва собствените HTTP заявки (като ВЗЕМЕТЕ, ПОСТ, СЛАГАМ, ИЗТРИЙ и т.н.), за да решите какво да правите, когато имате достъп до всяка крайна точка. За тях ще говоря по-късно.
Изходният формат на REST API е JSON, известен също като JavaScript Object Notation.
Пример за изхода на a ВЗЕМЕТЕ заявка към REST API на / users / id / 12 крайната точка може да изглежда както следва:
"id": 12,
"name": "Дейвид Смит",
"възраст": 42,
"телефони": ["124-211-2341", "889-211-4545"],
"country": "САЩ"
Както можете да видите, аз направих ВЗЕМЕТЕ заявка на / users / id / 12 крайната точка да каже на REST API да ми даде информация за потребителя, който има документ за самоличност 12. Получих само информацията, която поисках, нито повече, нито по-малко.
Сега да кажем, че искате информация за последните 10 потребители, които са се регистрирали на вашия уебсайт. Можете да направите a ВЗЕМЕТЕ заявка на / потребители / най-новите / 10 крайна точка.
Можете да добавите нови данни на вашия сървър, като използвате и REST API. Обикновено HTTP ПОСТ заявката се използва, за да се поиска от REST API да добави нови данни към API сървъра.
Например можете да направите a ПОСТ заявка на / потребители крайна точка с данните на новия потребител и тя ще бъде добавена към базата данни на вашия API сървър. Можете също така да конфигурирате вашия API за връщане на състоянието на заявката.
"statusCode": 400,
"statusText": "Потребителят е добавен успешно.",
"данни":
"id": 13,
"name": "Мери Смит",
"възраст": 35,
"телефони": ["124-211-2341", "889-211-4545"],
"country": "САЩ"
Както можете да видите, statusCode и statusText свойството на JSON обекта уведомява API клиента, че потребителят е добавен успешно. Добавените данни също се връщат в данни свойство на JSON обекта. Можете да конфигурирате своя API точно както искате.
Можете да актуализирате съществуващ запис и от базата данни на API сървъра. The СЛАГАМ HTTP заявката се използва в крайна точка на API за актуализиране на съществуващите данни в базата данни на вашия API сървър.
Да предположим например, че искате да актуализирате телефонния номер на потребителя с идентификатора 13. Можете да направите a СЛАГАМ заявка за крайната точка на API / user / id / 13.
"statusCode": 200,
"statusText": "Потребителят е актуализиран.",
"old_data":
"id": 13,
"name": "Мери Смит",
"възраст": 35,
"телефони": ["124-211-2341", "889-211-4545"],
"country": "САЩ"
,
"нови_данни":
"id": 13,
"name": "Мери Смит",
"възраст": 35,
"телефони": ["100-211-1111", "140-211-1145"],
"country": "САЩ"
Както можете да видите, операцията по актуализиране е успешна. Старите данни и новите данни се връщат в old_data и нови_данни свойство на JSON обекта съответно.
Можете също така да изтриете данни от базата данни на API сървъра с HTTP ИЗТРИЙ заявка за крайната точка на API.
Например, за да изтриете потребителя с идентификатор 12, можете да направите a ИЗТРИЙ заявка за крайната точка на API / user / id / 12.
"statusCode": 150,
"statusText": "Потребителят е премахнат.",
"данни":
"id": 12,
"name": "Дейвид Смит",
"възраст": 42,
"телефони": ["124-211-2341", "889-211-4545"],
"country": "САЩ"
Както можете да видите, потребителят се изтрива и изтритите потребителски данни се връщат в данни свойство на JSON обекта.
Обясних стандартния начин за използване на ВЗЕМЕТЕ, ПОСТ, СЛАГАМ и ИЗТРИЙ HTTP заявка за крайните точки на API за извършване на CRUD (Създаване, четене, актуализиране и изтриване) операция с помощта на REST API. Но можете да конфигурирате вашия API, за да прави определени неща при определени HTTP заявки. Тук нищо не е фиксирано. Например можете да актуализирате API, като използвате ВЗЕМЕТЕ HTTP заявка. Не е нужно да използвате СЛАГАМ. Това зависи от дизайнера на API.
Вие също проектирате крайните точки на API. Даването на смислени имена на крайните точки на вашия API прави вашия REST API много по-лесен за използване.
Приложения на REST API:
API-тата правят разработката на приложения по-лесна и модулна. С помощта на REST API можете лесно да пренасяте приложението си на различни платформи.
Всичко, което трябва да направите, е да проектирате и разработите REST API на вашето приложение. След това можете да използвате вашия REST API от вашия уебсайт, приложение за Android, приложение за iOS, приложение за Windows за настолни компютри и приложение за Linux и т.н. По този начин всички ваши приложения на различна платформа ще използват една и съща логика и времето и разходите ви за разработка ще бъдат намалени. Приложенията също ще бъдат по-лесни за управление. API REST се използват бързо и в уеб страници от една страница и в наши дни.
Написал съм статия за писане на REST API с помощта на Python. Благодаря, че прочетохте тази статия.
