Powiedzmy, że istnieje Produkt z Zamówieniami. Jeśli poprosisz o/products/product_id, zwróci 404, jeśli product_id nie istnieje. Ale powinien/products/product_id/orders zwróci 404, jeśli nie ma zamówień na ten produkt lub powinien zwrócić pustą tablicę?Czy RESTful API powinien zwracać 404 dla tablic obiektów?
Chciałbym zwrócić pustą kolekcję. Produkt z zerowymi zamówieniami jest całkowicie poprawną koncepcją, więc istnienie pustej kolekcji zamówień ma więcej sensu niż 404, co sugerowałoby, że produkt ten nie ma kolekcji zamówień.
+ 1, Poszliśmy tą drogą i jestem zadowolony z decyzji. – ale
Czy zamówienia powinny być uważane za samodzielny zasób? lub jakąś informację zwróconą przez zasób product_id? – chernevik
Chernevik Tak. Jeśli jest to inny adres URL i może zwrócić wartość 200, oznacza to inny zasób. Serwer może obsługiwać oba zasoby przy użyciu tego samego kontrolera, ale są to dwa różne zasoby. –
Powinieneś zrobić tylko jeden z dwóch rzeczy
Albo Zwraca 200 (OK) kod statusu oraz pustą tablicę w organizmie.
Lub Zwróć kod statusu 204 (NO CONTENT) i NIE CIAŁA odpowiedzi.
Dla mnie opcja 2 wydaje się bardziej technicznie poprawna i zgodna z zasadami REST i HTTP.
Jednak opcja 1 wydaje się bardziej wydajna dla klienta - ponieważ klient nie potrzebuje dodatkowej logiki do rozróżnienia dwóch kodów statusu (sukcesu). Ponieważ wie, że zawsze otrzyma tablicę, to po prostu musi sprawdzić, czy to ma żadnego, jeden, lub wiele pozycji i przetwarza je odpowiednio
moim zdaniem:
Mówimy wartości stanu HTTP tutaj i powinien mieć wyższy poziom udzielania odpowiedzi.
Należy to zobaczyć w warstwach uczestników. Podobnie jak wtedy, gdy api nie jest w stanie odpowiedzieć na prośbę, na wypadek, gdyby połączenie api było nieosiągalne, mógłbyś odpowiedzieć 404.
Ale kiedy twój telefon dzwoni i może odpowiadać zbiorem danych, ale jest to pusta kolekcja, możesz zwrócić tylko http 200, z pustym wynikiem.
Chciałbym użyć wartości statusu http, aby podać wskazanie na sprawdzanie poprawności wniosku, a nie bezpośrednio uzależnić go od zawartości w głębszych warstwach api.
Albo można by ściśle przestrzegać protokołów znalezione w internecie, ale nikt ich nie następuje ...
Nie zwracać tablic. Zwraca obiekt w każdym razie, jak
{
offset: 30,
limit: 10,
arr: []
}
pozwala dodawać metadane (dla paginacji lub smth indziej)
zwykle z kodem stanu HTTP: 200
Również ten jest konwencjonalne zachowanie interfejsu API sieci, kierowane przez bezpieczeństwa dotyczy: https://www.owasp.org/index.php/OWASP_AJAX_Security_Guidelines#Always_return_JSON_with_an_Object_on_the_outside
yo możesz zdefiniować własne wyniki. Daj każdemu wynikowi inny identyfikator – Grumpy
+1: Debatujemy teraz nad tym samym pytaniem, korzystając z kolekcji ofert wideo. –
@Grumpy możesz wyjaśnić, co masz na myśli trochę więcej? – rbp