Media Card - Recording | NAGRAVISION Documentation Portal

Retrieving Media Card information for a recording.

Request

To retrieve the Media Card information for a recording, send a GET request to:

https://<host>:<port>/metadata/v1/recordings/{id}/mediacard

Headers

Cache-Control – Caching rules for clients and web proxies
Content-Encoding - The compression level of the response

Mandatory arguments

id - The identifier of the content the mediacard concerns.

Other arguments

All these arguments are query parameters:

fields - A list of field names to return in the response.
deviceType - The type of the device making the query (e.g. Android) to filter out irrelevant results.
Accept-Language - The language (locale) of the response data.

Response

A successful request returns an HTTP 200 status.

A bad request returns an HTTP 400 status.

An unsuccessful request returns an HTTP 401 status.

The recommendations portion of the response is driven by a related recommendation based on the content; certain parts of the response are turned on or off through backend configuration.

Example

Click here to see an example.

JavaScript

{
  "recordingId": "77f44f7a-7b91-4436-9c5a-aa86a2c08ffe",
  "type": "recording",
  "Title": "Russia Today Programming",
  "Description": "Programming to be announced.",
  "Categories": [
    "Special"
  ],
  "Ratings": [],
  "eventId": "GLOBAL_98986_20220606050000",
  "contentId": "GLOBAL_98986_20220606050000",
  "products": [
    "1650964611283",
    "1650965644343",
    "1653472264853",
    "1653544761659",
    "1653635495190",
    "1653636213073",
    "1653647780657",
    "1654062336410",
    "DWH_TVOD_PRODUCT_NPVR88511",
    "GLOBAL_SIT_LIVE_PRODUCT01"
  ],
  "playback": {
    "ATV": {
      "drmId": null,
      "technicalId": "1648470934217",
      "uri": "http://cdn-nagravision-a-01.vos360.video/Content/DASH/LLCU/bd0fac7f-9588-4deb-a5ba-184df37e80cc/manifest.mpd"
    },
    "Chrome": {
      "drmId": null,
      "technicalId": "1648470934217",
      "uri": "http://cdn-nagravision-a-01.vos360.video/Content/DASH/LLCU/bd0fac7f-9588-4deb-a5ba-184df37e80cc/manifest.mpd"
    },
    "IOS": {
      "drmId": null,
      "technicalId": "1648471101715",
      "uri": "http://cdn-nagravision-a-01.vos360.video/Content/HLS/LLCU/bd0fac7f-9588-4deb-a5ba-184df37e80cc/index.m3u8"
    },
    "Android": {
      "drmId": null,
      "technicalId": "1648470934217",
      "uri": "http://cdn-nagravision-a-01.vos360.video/Content/DASH/LLCU/bd0fac7f-9588-4deb-a5ba-184df37e80cc/manifest.mpd"
    }
  }
}