Setting/updating the rating threshold | NAGRAVISION Documentation Portal

Request

To set or change the rating threshold(s) for the account (that is, the parental rating for which users will be prompted for the parental PIN), send a PUT request to:

https://<host>:<port>/adm/v1/user/accounts/parentalControl/actions/updateRatingsThresholds

Headers

x-correlation-id – identifier for logging, to correlate messages across a call flow
nv-tenant-id – the tenant ID
token – request authentication token

Mandatory arguments

If you do not supply a value for a parameter that already has a value, it will be set to null.

So the recommended approach is to use a GET https://adm/v1/user/accounts/parentalControl/ratingsThresholds request to get the currently set threshold(s), make the additions/changes you need to make, then use this modified set of parameters in the body of the PUT request.

The body consists of one or more key/value pairs, where :

The key is the name of the ratings body.
The value

Include a key/value pair for each applicable ratings body.

Other arguments

None

Example

A POST request with this payload sets/updates the ratings threshold for the specified ratings bodies:

{
  "FSK": "fsk12",
  "TVPG": "TV-MA"
}

Response

A successful request returns an HTTP 200 status.

A bad request returns an HTTP 400 status.

An unauthorised request returns an HTTP 401 status.

A forbidden request returns an HTTP 403 status.

If the account ID or tenant ID found in the token does not exist, the request returns an HTTP 404 status.