Note that there are some explanatory texts on larger screens.

plurals
  1. PO
    primarykey
    data
    text
    <p>You should put a "complete" representation as your media type defines it. If you're designing your own media type, your specification should define which parts are intended to be mutable and which are intended to be immutable. The Shoji Catalog Protocol, for example, defines <a href="https://bitbucket.org/fumanchu/shoji/src/5f7e3dcaaa725d38c6cd9b202cc205211798134d/spec.txt?at=default#cl-538" rel="nofollow">a "body" member</a> that is intended to contain the mutable data:</p> <blockquote> <p>In general, when a body member is present, processors SHOULD expect the values present within the body to be potentially mutable (via an HTTP PUT or POST, for example) and SHOULD expect any values outside the body member to be immutable; that is, (potentially) writable on insert but not on update. Servers are free, of course to allow or disallow mutability of any part of the resource. But the presence of a "body" member carries with it strong hints regarding the mutability of data both within and without that member.</p> </blockquote> <p>This isn't a standard (although it's so obviously useful to me that I'd like it to become one (wink)). Note that servers are free to do whatever they wish with the representation a client sends; the strongest requirement for any HTTP server is that it attempt to perform the intention of the client (if able and allowed). How and to what extent it does that is really a concern for your particular application, which is why you're not finding much in any specs about it.</p> <p>In practice, I haven't found it useful for the server to validate the links or other immutable parts of a representation; they're simply ignored. That can lead to clients deciding they can omit such. Again, in practice I haven't found that to be a problem.</p>
    singulars
    1. This table or related slice is empty.
    1. This table or related slice is empty.
    plurals
    1. This table or related slice is empty.
    1. This table or related slice is empty.
    1. This table or related slice is empty.
    1. VO
      singulars
      1. This table or related slice is empty.
    2. VO
      singulars
      1. This table or related slice is empty.
 

Querying!

 
Guidance

SQuiL has stopped working due to an internal error.

If you are curious you may find further information in the browser console, which is accessible through the devtools (F12).

Reload