Media hosting API

API for third-party applications to manage and upload media files hosted on Blubrry.com.

Concepts

Please refer to the API Concepts page for more information.

API Methods

The API methods below are RESTful implementations.

List Programs

Returns a list of hosted programs that the user has access to.

URL: http://api.blubrry.com/media/index.format
Formats: xml, json
Method(s): GET
Parameters:

  • limit – Optional. Specifies the number of results to return. Default is 20, 100 maximum. Ex: http://api.blubrry.com/media/index.json?limit=20
  • start – Optional. Specifies the start position of returned results. Ex: http://api.blubrry.com/media/index.json?start=0

Returned headers:

  • X-RawVoice-Total-Results – Indicates how many programs total are available to query. Header value can be used to determine if additional calls to List Programs is necessary.

Example output:

[xml]
<?xml version=”1.0? encoding=”UTF-8??>
<programs type=”array”>
<program>
<title>Program Title</title>
<keyword>program_keyword</keyword>
</program>
<program>
<title>Program Title Two</title>
<keyword>program_keyword_two</keyword>
</program>
</programs>
[/xml]

Returned headers:

X-RawVoice-Total-Results: 32

List unpublished media

Returns a list of unpublished media files for the specified program.

URL: http://api.blubrry.com/media/program_keyword/index.format
Formats: xml, json
Method(s): GET
Request URL Paramters:

  • program_keyword – Required. Specifies the program to list media files of. Ex: http://api.blubrry.com/media/program_keyword/index.json

Query string parameters:

  • limit – Optional. Specifies the number of results to return. Default is 20, 100 maximum. Ex: http://api.blubrry.com/programs/my_program/index.json?limit=20
  • start – Optional. Specifies the start position of returned results. Ex: http://api.blubrry.com/media/my_program/index.json?start=0

Returned headers:

  • X-RawVoice-Total-Results – Indicates how many unpublished media files are available to query. Header value can be used to determine if additional calls to List Unpublished Media is necessary.

Example output:

[xml]
<?xml version=”1.0? encoding=”UTF-8??>
<files type=”array”>
<file>
<name>Filename.ext</name>
<length>3634344</length>
<created>Mon Jan 26 19:47:15 +0000 2009</created>
<last_modified>Mon Jan 26 19:47:15 +0000 2009</last_modified>
</file>
<file>
<name>Filename2.ext</name>
<length>4635796</length>
<created>Tue Jan 27 11:47:56 +0000 2009</created>
<last_modified>Tue Jan 27 11:47:56 +0000 2009</last_modified>
</file>
</files>
[/xml]

Returned headers:

X-RawVoice-Total-Results: 561

Delete media

Deletes the specified media file.

URL: http://api.blubrry.com/media/program_keyword/mediafile.ext
Formats: xml, json
Method(s): DELETE
Request URL Paramters:

  • program_keyword – Required. Specifies the program to list media files of.
  • mediafile.ext – Required. Specifies the media file to delete.

Ex: http://api.blubrry.com/media/my_program/mediafile.ext

Query string parameters:

  • format – Optional. Specifies the format of the response returned. Ex: http://api.blubrry.com/media/my_program/mediafile.ext?format=json

Example output:

[xml]
<?xml version=”1.0″ encoding=”UTF-8″?>
<status>
<text>Media file deleted successfully.</text>
</status>
[/xml]

WebDAV methods

The method below is a WebDAV implementation.

Upload media

Uploads a media file to the server.

URL: http://api.blubrry.com/media/program_keyword/mediafile.ext
Formats: xml, json
Method(s): PUT
Request URL Paramters:

  • program_keyword – Required. Specifies the program for uploaded media file.
  • mediafile.ext – Required. Specifies the media file to upload.

Ex: http://api.blubrry.com/programs/my_program/mediafile.ext

Query string parameters:

  • format – Optional. Specifies the format of the response returned. Ex: http://api.blubrry.com/media/my_program/mediafile.ext?format=json

Request headers:

X-RawVoice-MD5-Checksum – Optional. MD5 checksum of the file being uploaded. When specified, the server will return the final uploaded MD5 checksum. The MD5 checksums should match.

X-RawVoice-Range – Optional. Range of start and end bytes which supports multi-PUT requests to upload content in chunks.

Returned headers:

X-RawVoice-MD5-Checksum: – Optional. MD5 checksum of the file uploaded.
X-RawVoice-Range: 0-536870912

Example output:

[xml]
<?xml version=”1.0″ encoding=”UTF-8″?>
<status>
<text>Media file uploaded successfully.</text>
</status>
[/xml]

Support

Please contact RawVoice for technical support.