{"idea":"A URL names a resource. The method names the action.","urls":[{"does":"list books; try ?author=Kleppmann or ?year=2015","method":"GET","url":"/api/books"},{"does":"read one book","method":"GET","url":"/api/books/1"},{"does":"create a book; send JSON {title, author, year}","method":"POST","url":"/api/books"},{"does":"replace book 1; send the full JSON object","method":"PUT","url":"/api/books/1"},{"does":"change only the fields you send, e.g. {\"year\": 2016}","method":"PATCH","url":"/api/books/1"},{"does":"remove book 2","method":"DELETE","url":"/api/books/2"},{"does":"list reviews nested under book 1","method":"GET","url":"/api/books/1/reviews"},{"does":"missing book; the server answers 404","method":"GET","url":"/api/books/99"}]}