The Restful Objects specification defines a set of RESTful resources, and corresponding JSON representations, for accessing and manipulating a domain object model.
Based on the definition of list in section 2.4.1, I would say that services is a better name.
However, I would like to know what is the actual representation type for a a list of references to domain services because I am implementing a RestfulObjects server side framework and I need to know which is the correct name.
In 7.2, the JSON representation example uses service as the representation type for the profile:
{ "links" : [ { "rel": "self", "href" : "http://~/services", "method" : "GET", "type" : "application/json;profile=\".../services\"" ... }
But services is not listed as one of the supported representation types in section 2.4.1 RepresentationType ("profile" parameter)
In section 2.4.1, there is a Representation type named list, which is defined as a list of references to domain services.
In section 5.2 Representation, there is an example JSON using list for services:
{ "rel": ".../services", "href": "http://~/services", "type": "application/json;profile=\".../list\"", "method": "GET" }
Based on the definition of list in section 2.4.1, I would say that services is a better name.
However, I would like to know what is the actual representation type for a a list of references to domain services because I am implementing a RestfulObjects server side framework and I need to know which is the correct name.