Publish with oEmbed

    Follow

    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 Screen9 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

    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


    Example call

    http://api.screen9.com/oembed?url=http%3A//console.screen9.com/%3Frequest%3Ddetails%26mediaid%3Dsamplemediaid

    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": "<iframe src=\"//csp.screen9.com/video?a=123\" width=\"1920\" height=\"1080\" frameborder=\"0\" mozallowfullscreen webkitallowfullscreen allowfullscreen></iframe>",
    "provider_name": "Screen9",
    "type": "video"
    }

     

     

    Was this article helpful?
    0 out of 0 found this helpful

    Comments