OpenTV ENTera & OpenTV Platform Documentation

Adding fallback and default images

Request

To ingest a fallback (or default image) – to be used when no content-related images are available – send a PUT request to:

https://<host>:<port>/imagemetadata/v1/fallback/{contentType}/upload

Headers

  • Content-Type: image/jpeg

Mandatory arguments

  • contentType (in URL) – one of the content types as present in the ingested data. (Supported values will vary depending on the operator, and can include values such as Movie, TV, Channel, Series, and Sports.)

To ensure there is a default image, ingest an image with contentType="default".

Other arguments

  • Multipart body containing binary image with form data param having name "image"

Examples

A PUT request like this:

https://<host>:<port>/imagemetadata/v1/fallback/movie/upload

... uploads an image to be used where the content is a "movie", but where no image related to the specific content item is available.

To upload a specific default image perform a PUT like this:

https://<host>:<port>/imagemetadata/v1/default/movie/upload

Responses

A successful request returns an HTTP 200 status.

A bad request returns an HTTP 400 status.

An unsuccessful request returns an HTTP 500 status.