Home

Java Viddler Api Client

Welcome to official Viddler API Java client library. You can download both compiled 1.5 java library and full source code of this library.

Features

• All Viddler’s methods support (including video file upload),
• XML to object mappings – parsing XML responses is not your problem anymore ;),
• Automatic requests sending retries
• Full Unicode support

Requirements

• JDK 5.0+
• Maven 2.0+ (for compiling sources)
• commons-http-client 3.1 (maven dependency),
• castor 1.0 (maven dependency)
• xerces 2.8.1 (maven dependecy)

How to compile sources

• Download sources
• Build project with maven: mvn package

How to use it?

ViddlerApiClient client = new ViddlerApiClient("my viddler api key");
try {
  ApiInfo apiInfo = client.viddlerApiGetInfo();
  System.out.println("Current Viddler API version is " + apiInfo.getVersion());
} catch (ApiException ae) {
  System.out.println("API returned error response: " + ae.getError());
} catch (ClientException ce) {
  System.out.println("Communitation problems: " + ce);
}

Known limitations

API client uses Apache commons httpclient which is build on top of blocking IO. In general this is not a problem but causes unwanted behavior during large files upload. Viddler checks upload headers and your access permissions before reading actual file stream. If any error happens (like file too large) – request processing is dropped and API response is returned. API client won’t be able to read the response before whole upload completes.

Version history

1.5.1

• Fixed invalid auth loop

1.5.0 – new features

• SSL support

1.4.0 – new features

• Added support for thumbnails upload

1.3.0 – new features for Viddler 1.5.0 API

• Added ability to add time comments
• Added videos and users search methods

1.2 – new features for Viddler 1.4.0 API

• Added viddler.videos.getByUser and viddler.videos.getByTag “sort” paramter support
• Added viddler.videos.setThumbnail method support
• Minor UTF-8 bugfixes

1.1 – extended features

• Added support for viddler.videos.prepareUpload method

1.0a – first preview release