Get rating results
/km/api/v1/content/{id}/ratings
This method returns a list of all the ratings results for a content record.
Example URIs
Following are the example URIs for this method:
http://<IM_REST_API_HOST>/km/api/latest/content/{id}/ratings
The request returns a paginated list of all the ratings results for a content record sorted by date added in ascending order.
http://<IM_REST_API_HOST>/km/api/latest /content/{id}/ratings?orderBy=dateAdded:desc
The request returns a paginated list of all the ratings results for a content record sorted by date added in descending order. The fields that you can sort are recordId, dateAdded, and dateModified.
Request
-
id: string
The content identifier.
Response
- application/json
- application/xml
200 Response
object
ResultList DataFormResults
-
allOf
Collection Paging Resource
Title:
Collection Paging Resource
Oracle base collection resource schema definition. -
object
ResultList DataFormResults-allOf[1]
Collection Paging Resource
-
allOf
Base Collection Resource
Title:
Base Collection Resource
Oracle base collection resource schema definition. -
object
Collection Paging Resource-allOf[1]
Base Collection Resource
-
object
Singular Resource
Title:
Singular Resource
Oracle base singular resource schema definition. -
object
Base Collection Resource-allOf[1]
object
Singular Resource
object
-
count(optional):
integer
Number of resource instances returned in the current range.
-
hasMore(optional):
boolean
Boolean value that is set to true if more resources are available on the server than the subset returned in current page.
-
limit(optional):
integer
Actual paging size used by the server.
-
offset(optional):
integer
Offset value used in the current page.
-
totalResults(optional):
integer
Total count of the resource instances, including both the instances in the current range and the instances on the server that satisfy the request.
array
-
Array of:
object instanceLink
Metadata describing link description objects that MAY appear in the JSON instance representation.
object
-
href:
string
URI [RFC3986] or URI Template [RFC6570]. If the value is set to URI Template, then the "templated" property must be set to true.
-
mediaType(optional):
string
Media type, as defined by RFC 2046, describing the link target.
-
method(optional):
string
HTTP method for requesting the target of the link.
-
profile(optional):
string
Link to the metadata of the resource, such as JSON-schema, that describes the resource expected when dereferencing the target resource..
-
rel:
string
Name of the link relation that, in addition to the type property, can be used to retrieve link details. For example, href or profile.
-
templated(optional):
boolean
Boolean flag that specifies that "href" property is a URI or URI Template. If the property is a URI template, set this value to true. By default, this value is false.
object
-
object
Singular Resource
Title:
Singular Resource
Oracle base singular resource schema definition. -
object
DataFormResultsKey-allOf[1]
object
-
recordId(optional):
string
The unique record ID of the DataFormResults object.
object
-
dateAdded(optional):
string(date-time)
The date when the DataFormResults object was created or added
-
dateModified(optional):
string(date-time)
The date when the DataFormResults object was last modified.
object
-
locale(optional):
LocaleKey
-
questions(optional):
array questions
To Many Relationship to DetailQuestionResult
-
user(optional):
UserKey
-
object
Singular Resource
Title:
Singular Resource
Oracle base singular resource schema definition. -
object
LocaleKey-allOf[1]
-
object
Singular Resource
Title:
Singular Resource
Oracle base singular resource schema definition. -
object
UserKey-allOf[1]
object
-
recordId(optional):
string
The unique identifier of the Locale object.
-
object
DetailQuestionResultKey
Title:
DetailQuestionResultKey
-
object
DetailQuestionResult-allOf[1]
object
DetailQuestionResultKey
-
recordId(optional):
string
The unique record ID of the DetailQuestionResult object.
-
referenceKey(optional):
string
The reference key for the DetailQuestionResult object. DetailQuestionResult objects support multiple languages. This field can be used to identify the associated objects for all languages.
object
-
answers(optional):
array answers
To Many Relationship to DetailAnswerResult
-
object
DetailAnswerResultKey
Title:
DetailAnswerResultKey
-
object
DetailAnswerResult-allOf[1]
object
DetailAnswerResultKey
-
recordId(optional):
string
The unique record ID of the DetailAnswerResult object.
-
referenceKey(optional):
string
The reference key for the DetailAnswerResult object. DetailAnswerResult objects support multiple languages. This field can be used to identify the associated objects for all languages.
object
-
text(optional):
string
Text of the DetailAnswerResult object
-
value(optional):
integer
Value of the DetailAnswerResult object
object
-
email(optional):
string
Email of the User object
-
externalId(optional):
integer
The ExternalId is the Id of the corresponding User from an external system. It, along with ExternalType, can be used to bridge the gap between a User from this system and a User from an external system.
-
externalType(optional):
string
The ExternalType is the type of the corresponding User from an external system. It, along with ExternalId, can be used to bridge the gap between a User from this system and a User from an external system.
-
name(optional):
string
User's full name
-
recordId(optional):
string
The unique record ID of the User object.
Examples
The following example shows how to find all ratings results for a Content record by submitting a get request on the REST resource using cURL.
cURL Command
Command: curl -X "GET" "http://<IM_REST_API_HOST>/km/api/latest/content/{id}/ratings"
Example of Request Header
The following shows an example of the request header.
-H "kmauthtoken: {\"siteName\":\"ORACLE_KNOWLEDGE\",\"integrationUserToken\":\"\"+eCJYkxKwj5HUaIiJYun0/TpatwT1LmtcsF05W33xnEojifV/AsLDj9RpN0lKuorTMNKeSE1tgC7svVL+BzntqDON4KiM1HFlpxvXEUCB0P2w0Xrs75McygqxdVaDSE9"}" \ -H "Accept: application/json"
Example of Response Body
The following shows an example of the response body in JSON format.
{ "items" : [ { "locale" : { "links" : [ { "rel" : "canonical", "href" : "http://<IM_REST_API_HOST>/km/api/{version}/{resourceURI}", "mediaType" : "application/json, application/xml", "templated" : true, "method" : "GET", "profile" : "http://<IM_REST_API_HOST>/km/api/{version}/metadata-catalog/{resourceName}" } ] }, "questions" : [ { "answers" : [ { "text" : "TEXT_VALUE", "value" : -1895849025, "referenceKey" : "REFERENCEKEY_VALUE" } ], "referenceKey" : "REFERENCEKEY_VALUE" } ], "user" : { "name" : "NAME_VALUE", "externalType" : "EXTERNALTYPE_VALUE", "links" : [ { "rel" : "canonical", "href" : "http://<IM_REST_API_HOST>/km/api/{version}/{resourceURI}", "mediaType" : "application/json, application/xml", "templated" : true, "method" : "GET", "profile" : "http://<IM_REST_API_HOST>/km/api/{version}/metadata-catalog/{resourceName}" } ] }, "links" : [ { "rel" : "canonical", "href" : "http://<IM_REST_API_HOST>/km/api/{version}/{resourceURI}", "mediaType" : "application/json, application/xml", "templated" : true, "method" : "GET" } ], "dateAdded" : "2013-04-30T21:34:23EDT", "dateModified" : "2013-04-30T21:34:23EDT" } ], "hasMore" : false, "limit" : 20, "offset" : 0, "count" : 1 }