anchor.diff:  {
     "authenticated":true
   }
  +
  +--
  +Personalized Content Rating API
  +
  +This part of API allows to obtain and store personalized content rating for any content stored inside Searchisko.  
  +This API cooperates with 'User Authentication Status API' to establish user authenticity, so you have to call 'User Authentication Status API' before you call this API.
  +All calls of this API return `403` Forbidden http response code if user is not authenticated!
  +--
  +
  +Get personalized content rating for one document.
  +
  +##### Request parameters
  +
  +* `id` unique identifier of the document in Searchisko to get personalized content rating for.
  +
  +##### Response content
  +
  +The response contains a JSON object where `your_rating` holds number value of rating which is number from 1 to 5.
  +
  +```
  +{
  +  "your_rating" : 2
  +}
  +```
  +
  +GET /rest/rating/{id}
  +< 200
  +< Content-Type: application/json
  +{
  +  "your_rating" : 2
  +}
  +
  +
  +Get personalized content rating for more documents.
  +
  +##### Request parameters
  +
  +* `id` unique identifier of the document in Searchisko to get personalized content rating for. Parameter can be used multiple times in one request to obtain rating for more documents at once.
  +
  +##### Response content
  +
  +The response contains a JSON object, where key is unique identifier of document in Searchisko (`id` request parameter) and value is structure with info about rating.
  +`your_rating` holds number value of rating which is number from 1 to 5.
  +If user did not provided his rating for some requested document yet, it is not present in response.
  +
  +```
  +{
  +  "id1" : { "your_rating" : 2},
  +  "id2" : { "your_rating" : 3},
  +}
  +```
  +
  +GET /rest/rating{?id}
  +< 200
  +< Content-Type: application/json
  +{
  +  "id1" : { "your_rating" : 2},
  +  "id2" : { "your_rating" : 3},
  +}
  +
  +
  +Rate content.
  +
  +##### Request parameters
  +
  +* `id` unique identifier of the document in Searchisko to store personalized content rating for.
  +* `my_rating` value of rating. Mandatory number from 1 to 5 (1 - worst, 5 - best). 
  +
  +POST /rest/rating/{id}{?my_rating}
  +< 200
   
   
   --
  
positive.code: --
  User Authentication Status API
  
  When Searchisko is configured to work with authentication server (like SSO) then the following endpoint can be used to
  learn if user has been successfully authenticated.
  --
  
  Learn if user has been authenticated.
  
  GET /rest/auth/status
  < 200
  
negative.code: * `hits` object containing info about search hits
  * `hits/total` total number of documents matching search request - search hits
  * `hits/hits` array with documents forming part of search hits matching `from` and `size` request parameters
  * `hits/hits/_id` unique identifier of document in Searchisko
  * `hits/hits/fields` document fields, see `field` request parameter
  * `hits/hits/highlight` highlights of fulltext matching in given document, see `query_highlight` request parameter
  * `facets` values from facets, see `facet` request parameter
  