To access all the latest updates, features & functionality we strongly advise that you use API v2

API v1 Has Been Deprecated

To access all the latest updates, features & functionality we strongly advise that you use API v2

Summary

This API call tells the vzaar system to process a newly uploaded video. This will encode it, if necessary, and then provide a vzaar video ID back.

Endpoint

/api/videos

Formats

  • XML (Note: remember to specify Content-Type header as 'application/xml' so that oAuth does not reject your request)
  • JSON

Arguments

  • None

Parameters

  • guid string - Specifies the guid to operate on
  • title string - Specifies the title for the video
  • description string - Specifies the description for the video
  • profile integer - Specifies the size for the video to be encoded in. If not specified, this will use the vzaar default or the user default (if set)
  • replace_id integer - Specifies the video ID of an existing video that you wish to replace with the new video.
  • transcoding boolean - True forces vzaar to transcode the video, false makes vzaar use the original source file (available only for mp4 and flv files)
  • labels string - Comma separated list of labels to be assigned to the video
  • *width integer - Specifies the width for the video
  • *bitrate integer - Specifies the bitrate for the video

*Only required if 'Custom' profile is specified

HTTP Methods

  • POST

Authentication

  • Required

    Notes

Profile ids

  1. Small
  2. Medium
  3. Large
  4. High Definition
  5. Original
  6. Custom

Replacing videos

* When replacing a video, you must have ownership of the video asset you're trying to replace. * When replacing a video, the source video file will be lost and only the new video file will remain

* Required

Responses

<?xml version="1.0" encoding="UTF-8"?>
  <vzaar-api>
  <video>integer</video>
  </vzaar-api>

Description

  • video - The vzaar video identifier and number. This is the unique identifier of the vzaar video asset.

Examples

Processing a video by http post (xml) with large size

Request

<?xml version="1.0" encoding="UTF-8"?>
  <vzaar-api>
  <video>
  <guid>vzcf7af7bc5a734c30a46ca3911e7f3458</guid>
  <title>Shakespeare Video</title>
  <description>To be or not to be, that is the question.</description>
  <profile>3</profile>
  <labels>label,another label,yet another label</labels>
  </video>
  </vzaar-api>

Response

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
  <vzaar-api>
  <video>1234567</video>
  </vzaar-api>



Replacing an existing video

Request

<?xml version="1.0" encoding="UTF-8"?>
  <vzaar-api>
  <video>
  <guid>vzcf7af7bc5a734c30a46ca3911e7f3458</guid>
  <replace_id>1234567</replace_id>
  <title>Shakespeare Video</title>
  <description>To be or not to be, that is the question.</description>
  <profile>3</profile>
  </video>
  </vzaar-api>

Response

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
  <vzaar-api>
  <video>1234567</video>
  </vzaar-api>

contact us   by phone, mail or twitter...
libraries
ruby java php .net node
affiliates
affiliate program


Powered by Olark