Należy użyć liczby pojedynczej lub mnogiej formy nazwy folderu w adresie URL

Question

Przykład 1:

http://www.example.com/image/logo.png 
http://www.example.com/images/logo.png 

Przykład 2:

http://www.example.com/user/johndoe 
http://www.example.com/users/johndoe 

Zwłaszcza jeśli użyć adresu URL jako REST API. (Przykład 2)

Który z nich jest zalecany i dlaczego?

Answer 1

Dla usługi REST używam przede wszystkim formy liczby mnogiej do wskazania ścieżki do zasobu. Musisz jednak wziąć również pod uwagę Cacheablility, Frequency of Change i Mutability of the Resource. W moim przypadku kolekcje zasobu dotyczą głównie przypadków, więc użyłem formy liczby mnogiej.

Powodem tego jest to, że na przykład:

http://www.example.com/users/johndoe 

posłuży URI, aby uzyskać johndoe użytkownika, który należy do kolekcji użytkowników.

http://www.example.com/users 

zostanie użyty jako URI uzyskanie wszystkich użytkowników i mogą być łatwo wykorzystane na url zapytań jak:

http://www.example.com/users?limit=5 

tworzenia nowego użytkownika będzie nadal korzystać z tego samego adresu URL, a następnie za pomocą POST & odejście parametry:

http://www.example.com/users 

dla literatury może chcesz sprawdzić książkę oreilly relaksującego Web Services Cookbook

Answer 2

Moje osobiste preferencje to używanie innego adresu URL do pojedynczych i wielu zasobów.

http://www.example.com/users powiedzieć, że chcę wszystkie zastosowania. Możesz dodać parametry zapytania, aby filtrować wyniki.

Na odwrotnie http://www.example.com/user/johndoe - wyraźnie stwierdza, że ​​chcę pojedynczego użytkownika, którego id jest johndoe.

Zalety: 1. Nie można prawidłowo ustawić oczekiwań. 2./użytkowników bez wyników można powrócić 201 zamiast 404 3./użytkownik/może zwrócić 401, który jest stan błędu.