Rzeczywiste przykłady dla HATEOAS (architektura REST) ​​[zamknięte]

jak każdy mógł zauważyć, istnieje wiele fałszywych / podstawowych interfejsów API REST na wolności (które implementują HTTP-API i nazywają go REST bez przestrzegania wymagania hipertekstu jako silnika stanu aplikacji, co doprowadziło do słynnej tyrady Roya T. Fieldinga , człowieka, który jako pierwszy określił paradygmat REST).

Nie udało mi się znaleźć żadnych praktycznych przykładów prawdziwie sterowanej hipertekstem implementacji REST wraz z powiązanymi definicjami typów mediów specyficznych dla aplikacji dla przejść między stanami.

Czy są dostępne publicznie przykłady takich realizacji?

Nie jest to implementacja w sensie uruchamiania kodu, ale bardzo podoba mi się artykuł „ Jak dostać filiżankę kawy ” w InfoQ. Opisuje proces zamawiania kawy w Starbucks jako protokół RESTful. Wykracza to poza typowy artykuł wprowadzający REST „wszystko jest zasobem” i koncentruje się na HATEOAS. Wysoce rekomendowane.

A co z Sun Cloud API ? Od wprowadzenia:

API z góry nie zakłada żadnej określonej struktury w przestrzeni URI. Punktem wyjścia jest identyfikator URI dostarczony przez dostawcę usług w chmurze, który identyfikuje samą chmurę. Reprezentacja chmury zawiera identyfikatory URI dla innych zasobów w chmurze, a także dla operacji, które można na nich wykonać (na przykład wdrażanie i uruchamianie maszyn wirtualnych).

Fabuła może również być pomocne.

Netflix ma REST API oparty na HATEOAS, który zawiera linki jako część zasobów.

Czy w czwartym punkcie Roya nie odniesiono się do RESTfulness Sun Cloud API:

REST API nie może definiować stałych nazw zasobów ani hierarchii (oczywiste połączenie klienta i serwera). Serwery muszą mieć swobodę kontrolowania własnej przestrzeni nazw. Zamiast tego pozwól serwerom instruować klientów, jak konstruować odpowiednie identyfikatory URI, na przykład w formularzach HTML i szablonach URI, definiując te instrukcje w typach mediów i relacjach łączy. [Błąd w tym miejscu oznacza, że ​​klienci przyjmują strukturę zasobów ze względu na informacje pozapasmowe, takie jak standard specyficzny dla domeny, który jest zorientowanym na dane odpowiednikiem funkcjonalnego sprzężenia RPC].

Przykład 1 Stałe nazwy zasobów w zdefiniowanym dziedziczeniu:

Z Sun Cloud API: „… reprezentacja VDC będzie zawierała reprezentacje klastrów, które go zamieszkują, które z kolei obejmują reprezentacje maszyn wirtualnych w każdym klastrze”.

Przykład 2 informacje pozapasmowe, takie jak standard domeny:

Musisz mieć zawartość strony wiki (informacje spoza pasma), aby wiedzieć, że „mechanizm komunikacji zasobów” dla pola zasobów chmury „uri” to GET.

Zdałem sobie sprawę, że pytano o to jakiś czas temu, ale próbowałem zademonstrować „właściwy” przepływ interfejsu API REST, aby uzyskać prosty przykład. Próbowałem postępować zgodnie z regułami Roya dla REST - być może mogłoby to pomóc: Przykład API z wykorzystaniem REST