OpenTV ENTera & OpenTV Platform Documentation

Retrieving products for an authenticated account – predefined query

Using pre-defined queries

To retrieve products which are associated with an authenticated account (known from the authentication details), use the predefined query API which both abstracts away the complexity of the underlying data model and provides for the most performant query.

Request

To retrieve the products that the account is subscribed to, send a GET request to:

https://<host>:<port>/<endpoint>/metadata/v1/subscribed/products

Headers

  • Authorization: Bearer – bearer token

  • Content-Type: application/json

Mandatory arguments

None

Other arguments

All these arguments are query parameters:

  • fields – a list of fields names to return in the response

  • page – the page of results to retrieve

  • limit – the page size

  • Accept-Language – the language (locale) of the response data

Response

A successful request returns an HTTP 200 status.

A bad request returns an HTTP 404 status.

Example

Get available products that the account is subscribed to, returning ID and title:

https://<host>:<port>/metadata/v1/subscribed/products?fields=id&fields=Title

See also

The Content discovery facade API documentation