Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Available contextual data partners will can utilize the Context API route to retrieve the source_url for an iris_id. The contextual data provider will be responsible for querying IRIS.TV when they receive an unknown iris_id.

...

Context API Route for Retrieval:

The iris_id should be passed as a query parameter. The access_token is passed in the header. Here’s a curl example of the request:

Code Block
$ curl -D - -H "Authorization: Bearer eyJlbmMiOiJBMjU2Q0JDLUhTNTEyIiwiYWxnIjoiZGlyIn0..QDidXo9Z96KCluZ4kLbtMg.Fw3Wm064Co78iCFWtBL8Hwp-RX7YgtsvsXGizHKv3w0.EJiELVDD14HmqkuvzPfunjIaKS3427GOaFqsvIs8MUc" https://context.iris.tv/refresh?access_token=98aljfalmn&iris_id=iris_46akanap55824d003e738991

If the iris_id is valid, IRIS.TV will return a 200 response with the following parameters:

...

Code Block
{    "source_url" : "https://www.sample_pub_url.mp4",
     "iris_id" : "iris_78191lilpoe019",
     "iris_id_expires_at" : 1588291200,
     "iris_id_next" : "iris_1897aflaja",
     "iris_id_next_expires_at" : 1588401200
     }

Retrieving a New iris_id When One

...

Has Expired:

Once the TTL for an asset’s iris_id has passed, the data partner will query IRIS.TV with an asset URL to retrieve the new iris_id.

...