User:Drakken Keisterbane/CREST: Difference between revisions

Line 21:

==Representations==

Resources are represented as "hypermedia documents which link to related resources." (<- cite) The structure that a representation uses is dictated by '''media types''', identifiers used to indicate the type of data files on the internet contain. This means that there is a separate media type for each subsequent version of a given representation. Note that a representation can be appended in order to add new functionality, so applications must be able to ignore any extra unneeded information they may receive. Under normal circumstances, names and attributes in representations are not changed or removed. However, if it is required to changed or remove these, a new version of a representation will be made with the changes. This new representation will be assigned its own media type, and CCP will keep the old version up as long as possible.

It is important to state that applications will always be served the ''newest'' version of a representation by default, so that new applications use the newest version. It is very important to explicitly state which version of a given representation you are relying on in order to ensure the continued functionality of your applications, especially if these rely on the structure of a particular version of the representation.

You can specify which version of a representation(s) you'd like your application to deal with by using the '''Accept''' header to specify what version of a representation you want to receive and the '''Content-Type''' header to specify what version to send out.

=Usage=

@@ Line 21: / Line 21: @@
 ==Representations==
+Resources are represented as "hypermedia documents which link to related resources." (<- cite) The structure that a representation uses is dictated by '''media types''', identifiers used to indicate the type of data files on the internet contain. This means that there is a separate media type for each subsequent version of a given representation. Note that a representation can be appended in order to add new functionality, so applications must be able to ignore any extra unneeded information they may receive. Under normal circumstances, names and attributes in representations are not changed or removed. However, if it is required to changed or remove these, a new version of a representation will be made with the changes. This new representation will be assigned its own media type, and CCP will keep the old version up as long as possible.
+It is important to state that applications will always be served the ''newest'' version of a representation by default, so that new applications use the newest version. It is very important to explicitly state which version of a given representation you are relying on in order to ensure the continued functionality of your applications, especially if these rely on the structure of a particular version of the representation.
+You can specify which version of a representation(s) you'd like your application to deal with by using the '''Accept''' header to specify what version of a representation you want to receive and the '''Content-Type''' header to specify what version to send out.
 =Usage=