Jak działają REST API
Dlaczego warto używać interfejsu API REST:
W tradycyjnych aplikacjach internetowych powiedzmy prosty serwer WWW PHP,
- Poprosisz o stronę (powiedzmy php) z serwera.
- Serwer znajduje plik skryptu (php) odpowiadając zaproszonej strony i rozpoczyna ją wykonywanie. Skrypt łączy się z bazą danych, szuka wymaganych informacji, umieszcza informacje na stronie w ładnie sformatowany sposób (mieszanie HTML + CSS + JavaScript z danymi), który wygląda bardzo atrakcyjnie dla odwiedzającego.
- Następnie serwer wysyła go z powrotem do gościa.
W tym modelu wszystkie przetwarzanie odbywa się po stronie serwera. Więc serwer musi wykonać więcej pracy. Tutaj dane nie są oddzielone od strony, są głęboko wbudowane w stronę.
Jeśli w przyszłości chcesz stworzyć aplikację na Androida lub aplikację na iOS lub aplikację komputerową swojej witryny, będziesz musiał wykonać dużo więcej pracy. Będziesz musiał połączyć się z bazą danych bezpośrednio z każdej z tych aplikacji, co może nie być bardzo bezpieczne. Czas rozwoju wzrośnie i pojawią się problemy z przenośnością.
Powiedzmy, że z powodzeniem stworzyłeś aplikacje komputerowe, Android i iOS z Twojej witryny. Pełna nazwa użytkownika jest wyświetlana małymi literami w każdym z nich. Teraz chciałbyś to pokazać w Guvercase. Cóż, programiści muszą oddzielnie zmodyfikować wersję komputerów stacjonarnych, Android i iOS, aby to zrobić. Który jest czasochłonny. W prawdziwym świecie sprawy nie będzie tak proste jak ten. Tak więc jedna wersja aplikacji (powiedzmy, że wersja komputerowa) może mieć poważny błąd w procesie aktualizacji. Naprawienie go później zajęłoby więcej czasu. Czy widzisz, jak rośnie czas rozwoju? To rozwiązanie nie jest również przenośne.
W API REST pytasz serwer API, czego potrzebujesz, i wysyła on tylko informacje, o które prosisz. Nie ma potrzeby niepotrzebnego przetwarzania na serwerze. Tak więc wydajność Twojej witryny i aplikacji jest naturalnie ulepszona. Możesz także użyć tych samych danych w swojej stronie internetowej, aplikacji komputerowej, Android i iOS. Zmiany wprowadzone na serwerach zostaną odzwierciedlone w aplikacjach korzystających z API. Czas i koszt rozwoju aplikacji również zostaną skrócony.
Jak działa API REST:
Reszty interfejsy API mają punkty końcowe. Punkt końcowy jest niczym więcej niż adresem URL, ale w ładnie sformatowany sposób i ma znaczenie. Używa natywnych żądań HTTP (takich jak DOSTAWAĆ, POST, UMIEŚCIĆ, USUWAĆ itp.) Aby zdecydować, co zrobić, gdy uzyskujesz dostęp do każdego punktu końcowego. Porozmawiam o tym później.
Format wyjściowy interfejsu API REST to JSON znany również jako notacja obiektu JavaScript.
Przykład wyjścia DOSTAWAĆ prośba do interfejsu API REST /użytkownicy/id/12 Punkt końcowy może wyglądać w następujący sposób:
„ID”: 12,
„Nazwa”: „David Smith”,
„Wiek”: 42,
„Telefony”: [„124-211-2341”, „889-211-4545”]],
„Kraj”: „Us”
Jak widać, zrobiłem DOSTAWAĆ prośba o /użytkownicy/id/12 punkt końcowy, aby poinformować API REST, aby przekazać mi informacje o użytkowniku, który ma ID 12. Mam tylko informacje, o które prosiłem, nic więcej, nic więcej.
Powiedzmy teraz, że chcesz informacji o 10 ostatnich użytkownikach, którzy zarejestrowali się na Twojej stronie internetowej. Możesz zrobić DOSTAWAĆ prośba o /Użytkownicy/najnowsze/10 punkt końcowy.
Możesz dodać nowe dane na serwerze również za pomocą interfejsu API REST. Zwykle HTTP POST Żądanie służy do proszenia interfejsu API REST o dodanie nowych danych do serwera API.
Na przykład możesz zrobić POST prośba o /użytkownicy punkt końcowy z danymi nowego użytkownika i zostanie on dodany do bazy danych na serwerze API. Możesz także skonfigurować interfejs API, aby zwrócił status żądania.
„STATHCODE”: 400,
„Statustext”: „Użytkownik pomyślnie dodał.",
"dane":
„ID”: 13,
„Nazwa”: „Mary Smith”,
„Wiek”: 35,
„Telefony”: [„124-211-2341”, „889-211-4545”]],
„Kraj”: „Us”
Jak widać, Kod statusu I Statustext właściwość obiektu JSON powiadamia klienta API, że użytkownik jest pomyślnie dodany. Dodane dane są również zwracane w dane właściwość obiektu JSON. Możesz skonfigurować swój interfejs API tak, jak chcesz.
Możesz zaktualizować istniejący rekord z bazy danych serwera API. UMIEŚCIĆ Żądanie HTTP jest używane w punkcie końcowym API do aktualizacji istniejących danych w bazie danych serwera API.
Załóżmy na przykład, że chcesz zaktualizować numer telefonu użytkownika o identyfikator 13. Możesz zrobić UMIEŚCIĆ żądanie w punkcie końcowym API /użytkownik/id/13.
„Kod statusowy”: 200,
„Statustext”: „Zaktualizowano użytkownika.",
„Old_data”:
„ID”: 13,
„Nazwa”: „Mary Smith”,
„Wiek”: 35,
„Telefony”: [„124-211-2341”, „889-211-4545”]],
„Kraj”: „Us”
,
"nowe dane":
„ID”: 13,
„Nazwa”: „Mary Smith”,
„Wiek”: 35,
„Telefony”: [„100-211-1111”, „140-211-1145”],
„Kraj”: „Us”
Jak widać, operacja aktualizacji się powiodła. Stare dane i nowe dane są zwracane w Old_Data I nowe dane właściwość odpowiednio obiektu JSON.
Możesz także usunąć dane z bazy danych serwera API z HTTP USUWAĆ żądanie w punkcie końcowym API.
Na przykład, aby usunąć użytkownika z ID 12, możesz zrobić USUWAĆ żądanie w punkcie końcowym API /użytkownik/id/12.
„Kod statusowy”: 150,
„Statustext”: „Usunięto użytkownika.",
"dane":
„ID”: 12,
„Nazwa”: „David Smith”,
„Wiek”: 42,
„Telefony”: [„124-211-2341”, „889-211-4545”]],
„Kraj”: „Us”
Jak widać, użytkownik zostaje usunięty, a usunięte dane użytkownika są zwracane w dane właściwość obiektu JSON.
Wyjaśniłem standardowy sposób korzystania z DOSTAWAĆ, POST, UMIEŚCIĆ I USUWAĆ Żądanie HTTP w punktach końcowych API w celu wykonania operacji CRUD (Utwórz, odczyt, aktualizuj i usuń) za pomocą API REST. Ale możesz skonfigurować interfejs API, aby robienie pewnych rzeczy na określone żądanie HTTP. Nic tu nie jest ustalone. Na przykład możesz zaktualizować interfejs API za pomocą DOSTAWAĆ Żądanie HTTP. Nie musisz używać UMIEŚCIĆ. To zależy od projektanta API.
Projektujesz również punkty końcowe API. Podawanie znaczących nazw punktów końcowych API sprawia, że interfejs API REST jest znacznie łatwiejszy w użyciu.
Zastosowania API REST:
API sprawiają, że tworzenie aplikacji jest łatwiejsze i modułowe. Za pomocą API REST możesz łatwo przenieść aplikację na różne platformy.
Wszystko, co musisz zrobić. Następnie możesz użyć interfejsu API REST z witryny, aplikacji na Androida, aplikacji iOS, aplikacji komputerowej i aplikacji Linux itp. W ten sposób wszystkie aplikacje na innej platformie będą korzystać z tej samej logiki, a Twój czas i koszt rozwoju zostaną skrócony. Aplikacje będą również łatwiejsze do zarządzania. API odpoczynku są obecnie używane szybko w aplikacjach internetowych w jednej stronie.
Napisałem artykuł na temat pisania API REST za pomocą Pythona. Dziękujemy za przeczytanie tego artykułu.