W tym identyfikator w URI dla żądań PUT

Question

Czytałem kilka dokumentów na temat właściwego korzystania z URI przy użyciu usług odpoczynku i natknąłem się na przykład dla podstawowych żądań GET .. DELETE.

Przykładowe uri byli:

Uzyskaj wszystkich użytkowników

GET http://mydomain.org/api/users 

Get konkretnego użytkownika

GET http://mydomain.org/api/users/1 

Aktualizacja użytkownik

PUT http://mydomain.org/api/users/1 

usunąć użytkownika

DELETE http://mydomain.org/api/users/1 

Zasób użytkownik będzie albo JSON lub XML w postaci:

{ 
    Id: 1, 
    FirstName: 'John', 
    LastName: 'Doe' 
} 

Moje pytanie jest takie. Aby zachować zasady REST, czy należy podać identyfikator zasobu w URI dla żądań PUT?

Answer 1

Metoda PUT żąda, aby zamknięty obiekt był przechowywany w dostarczonym URI żądania.

Chcesz PUT zasób do tego samego identyfikatora URI, który chcesz GET go od.

RFC 2616 9.6 PUT

Answer 2

miałem zamiar zadać podobne pytanie, ale myślę, że znalazłem odpowiedź. Nie jestem pewien, czy jest to zgodne z zasadami REST, ale właśnie dlatego byłoby źle nie uwzględniać identyfikatora w URI. Tak mówią Twój PUT jest jak:

PUT http://mydomain.org/api/users 

I wtedy stało się zaktualizowanie wielu użytkowników o różnych id, ale samego URI przyczyna nie ma ID w URI. Następnie ważną rzeczą, o której warto wiedzieć, jest to, że PUT jest idempotentem http verb. Oznacza to, że wywoływanie go raz powinno mieć taki sam efekt, jak nazywanie go kilkoma razy. Dlatego niektóre węzły pośrednie w sieci, następujące po tym, że PUT wielokrotnie, mogą zignorować wszystkie z wyjątkiem jednego z żądań, ponieważ mają ten sam identyfikator URI. Wreszcie, to zdecydowanie nie jest to, co chcesz, ponieważ intencją było zaktualizować wielu użytkowników, nie tylko jeden.