oEmbed - Publishing
oEmbed is a standard (http://oembed.com) for making publishing of content easy.
Any URL to a video page from the Account Console or from the Videosite can be used with the Quickchannel oEmbed.
An embed code can be retrieved for any video, but only videos that have moderation set to allowed and are within any publication windows can be accessed.
Activation
Please consult your sales representative about activating oEmbed on your account.
API
API endpoint: http://api.screen9.com/oembed
| Supported parameters | |
| format | Returned format (json or xml) |
| maxheight | Maximum allowed height of video |
| maxwidth | Maximum allowed width of video |
| url | URL of resource to embed; please note the unsafe and reserved characters in the URL need to be quoted as per RFC-1738, |
If maxheight or maxwidth is not set, The height and width of the video is used. Due to the oEmbed specification, the returned embed code is not responsive.
The returned format is always json unless explicitly set to XML. Format may also be specified by Accept headers in the request.
| Response fields | |
| height | Height of video embed |
| html | Embed code returned |
| provider_name | Name of oEmbed provider |
| provider_url | URL to oEmbed provider |
| thumbnail_height | Thumbnail height |
| thumbnail_url | Url to thumbnail of video |
| thumbnail_width | Thumbnail width |
| title | Title of video |
| type | Type of content: "video" |
| version | oEmbed version: 1.0 |
| width | Width of video embed |
A sample response would be:
{
"provider_url": "https://www.screen9.com",
"version": 1.0,
"thumbnail_width": 160,
"height": 1080,
"thumbnail_url": "https://csp.screen9.com/img/thumbnail.jpg",
"thumbnail_height": 120,
"title": "ateam onepass vbv 1.0 1.0",
"width": 1920,
"html": "",
"provider_name": "Screen9",
"type": "video"
}