18 Dec
2008
18 Dec
'08
11:39 a.m.
Dear all,
I haven't seen any comment about the second proposal I did.
It basically "moves" some URI path elements to the parameter list. These
elements are the ones that introduces a degree of variability wrt to the
resource, namely language and version.
For example with a single URI:
/spaces/{space}/pages/{page}[?lang=l&version=v]
I can get the page at its latest version in the default language (no
query parameters) or, by combining the query parameters, any page at a
specific version in a given language.
I think it is worth thinking about it because, by following the previous
example, the 8 URIs in the "pages" section could be reduced to 4.
Similarly for other resources where the "version element" basically
introduces a doubling of the resources to be exposed (e.g., as it
happens with objects and attachments).
WDYT?
-Fabio