czym jest odpoczynek?
wiele publicznie dostępnych usług udostępnia REST API, które umożliwia szeroką gamę aplikacji, od interfejsów internetowych po integrację i synchronizację systemów back-end. Czym dokładnie jest REST i co sprawia, że API jest RESTful?,
REST – Reprezentacyjny Transfer stanu
technicznie REST oznacza Reprezentacyjny Transfer stanu (więc nie jest to doskonały akronim) i zasadniczo oznacza, że jest to architektura przeznaczona do przesyłania reprezentacji danych lub stanu serwera między Klientem a serwerem.
istnieje kilka szczegółowych kryteriów, które są uważane za niezbędne, aby API było RESTful, ale najważniejsze jest, aby API było:
- Stateless
oznacza to, że nie ma niezbędnej sesji między Klientem a serwerem., Dane otrzymane z serwera mogą być wykorzystywane przez Klienta niezależnie. Pozwala to na krótkie, dyskretne operacje, a nawet buforowanie danych w trybie offline. To sprawia, że REST jest naturalnym rozwiązaniem dla operacji HTTP, w których żądania mają być pojedyncze i krótkotrwałe.
- Uniform
REST API mają być samoopisujące się, jednolite w swojej definicji, a każda operacja oddzielona innym punktem końcowym lub adresem URL. W praktyce większość interfejsów API REST implementuje klasyczne operacje CRUD (Create, Read, Update, Delete) względem modelu danych., Ta jednorodność pozwala programistom na łatwe poznanie wzorca użytkowania każdego API.
jak więc wygląda REST API?
ponieważ ma być reprezentacyjny, zacznijmy od modelu danych, który ma reprezentować. Na przykład, jeśli mamy aplikację do handlu online, chcielibyśmy zdefiniować operacje zarządzania produktami w naszym katalogu, skupione wokół modelu produktu.
każda z tych operacji byłaby powiązana z kombinacją adresu URL i czasownika HTTP., Aby przejrzeć, istnieje wiele czasowników HTTP, ale większość programistów internetowych używa tylko czasowników GET I POST do żądania adresu URL lub danych formularza. Ale REST używa więcej czasowników HTTP, aby zasygnalizować serwerowi, jaki rodzaj operacji wykonuje klient.
poniżej znajduje się uproszczona lista adresów URL w połączeniu z czasownikiem HTTP, którego użyjemy do udostępnienia pełnego interfejsu API do zarządzania katalogiem produktów:
powyższe operacje i adresy URL to tylko podstawowe operacje na jednym modelu., Interfejsy API REST mogą również obsługiwać bardzo specyficzne operacje lub operacje hierarchiczne. Na przykład, jeśli chcesz wysłać sygnał do serwera, aby zmienić kolejność dostaw produktów, możesz ujawnić adres URL taki jak:
/products/{id}/reorder | POST | sygnalizuje serwerowi, że chcesz zmienić kolejność ilości produktu {ID}. Treść wiadomości może być pusta lub zawierać model danych używany do szczegółowych instrukcji dotyczących operacji zmiany kolejności., |
lub, jeśli chcesz zanurzyć się w katalogu produktów i uruchomić zapytanie, aby zwrócić listę wszystkich zamówień dla danego produktu, API może wystawić taką operację:
/products/{id} /orders | Pobierz | po otrzymaniu {ID} dla produktu zwróć wszystkie zamówienia., |
odwrotnie, możesz wyświetlić punkt końcowy zorientowany na zamówienie, który pozwala wyświetlić listę wszystkich produktów w zamówieniu:
jak wyglądają dane serwera?,
chociaż nie ma ścisłego wymogu, jakiego typu danych używa LUB Zwraca API REST, stało się de facto standardem dla internetowych interfejsów API REST, aby używać JSON jako definicji danych.
dzieje się tak dlatego, że JSON jest natywnym formatem, którego wszystkie nowoczesne przeglądarki mogą używać do reprezentowania obiektów hierarchicznych. Aby uzyskać więcej informacji na temat JSON, przeczytaj nasz artykuł Co To jest JSON?
aby dowiedzieć się więcej o naszych produktach, skontaktuj się z przedstawicielem handlowym OAS toll free w USA pod numerem 1-800-533-4994 lub w przypadku pytań międzynarodowych zadzwoń pod numer 1-303-679-0898.