ioio.tv APIs

# Mediatailors Update

API call format

PUT /broker/mediatailors/<mediatailor_guid>                 //Use token autorization
PUT /broker/private/mediatailors/<mediatailor_guid>         //Use Api Key
{
  "name": "string",
  "slate_ad": "string",
  "ad_server": "string",
  "type": "broker",
  "source_url": "string"
}

Description

This call updates existing mediatailor object.

Precondition

  • Authorization token/Api key is needed.
  • Mandatory elements (should be specified):
    • "<mediatailor_guid>" - valid mediatailor guid. Take a specific mediatailor guid using Mediatailors List API call.
    • "name" - mediatailor name.
    • "ad_server" - mediatailor ad server link.
    • "type" - "live" or "broker".
  • Not mandatory (optional):
    • "<slate_ad>" - slate_ad.

Postcondition

  • On success response code should be 200
  • On success message for successful update in JSON format is returned.
  • On failure an error will be returned with the right error code and description.

Example:

[Request] PUT https://<base_api_url>/broker/mediatailors/<mediatailor_guid>
[Request] PUT https://<base_api_url>/broker/private/mediatailors/<mediatailor_guid>
{
  "name": "<mediatailor_name>",
  "slate_ad": "string",
  "ad_server": "https://drive.google.com",
  "type": "broker",
  "source_url": "string"
}  
[Request Headers] {"Content-Type":"application/json","Accept":"application/json","Authorization":"<IdToken>"} //Use token autorization
[Request Headers] {"Content-Type":"application/json","Accept":"application/json","X-Api-Key":"<api_key>"}     //Use Api Key

[Response] 200
[Response Headers] {"Content-Type":["application/json"],"Content-Length":["..."],"Connection":["keep-alive"],"Date":["..... GMT"],"x-amzn-RequestId":["....."],....]}
[Response] 
{
    "status":true,
    "data":"Item was updated successfully"
}

← Mediatailors Delete →