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 allows a user to upload & process video file from given url.

Endpoint

/api/upload/link.xml

Formats

  • XML
  • JSON

Parameters

  • key string - A name for the S3 object that stores the uploaded file
  • guid string - Specifies the guid to operate on
  • url string - Specifies the url to video file
  • encoding_params node - Includes optional parameters
  • title string - Specifies the title for the video
  • description string - Specifies the description for the video
  • width integer - Specifies video's width
  • size_id integer - Specifies the size for the video to be encoded in
  • bitrate integer - Specifies video's bitrate
  • transcoding boolean - True forces vzaar to transcode the video, false makes vzaar use the original source file
  • HTTP Methods

    • POST

    Authentication

    • Required

    Example

    Call http://vzaar.com/api/upload/link.xml

    Request (http post)

    <?xml version="1.0" encoding="UTF-8"?>
      <vzaar-api>
        <link_upload>
          <key>vzaar/vzc/9d9/source/vzc9d9f1e4a4814c858eadca7e4bfb5c0d/${filename}</key>
          <guid>vzc9d9f1e4a4814c858eadca7e4bfb5c0d</guid>
          <url>http://samples.mplayerhq.hu/MPEG-4/turn-on-off.mp4</url>
          <encoding_params>
            <title>My Video</title>
            <description>My Video</description>
            <size_id>My Video</size_id>
            <bitrate>128</bitrate>
            <width>640</width>
            <transcoding>true</transcoding>
          </encoding_params>
        </link_upload>
      </vzaar-api>
    
    

    Response (success - HTTP STATUS CODE: 200):

    <?xml version="1.0" encoding="utf-8\"?>
      <vzaar-api>
        <id>8235423</id>
      </vzaar-api>
    
    

    Response (failure - HTTP STATUS CODE: 422):

    <?xml version="1.0" encoding="utf-8\"?>
      <vzaar-api>
        <status>Failure</status>
        <errors>
          <url>empty string</user>
        </errors>
      </vzaar-api>
    
    

    Checking video's status (HTTP STATUS CODE: 200):

    <?xml version="1.0" encoding="utf-8\"?>
      <vzaar-api>
        <video>
          <id>1942300</id>
          <state>Processing not complete</state>
          <video_status_id>1</video_status_id>
        </video>
      </vzaar-api>
    
    

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


    Powered by Olark