Social - Share - Add - Binary
/social/share/add/binary/{title}/{description} (POST)
Saves a binary file to the share library. Typical uses for binary files include widget thumbnail images, widget swf files, and hadoop map reduce jars.
A simple web-based utility is available for performing many share management activities.
Authentication
Required, see Auth - Login
Arguments
title (required)
a title of the binary file you are adding
description (required)
the description of the binary file you are adding
binary (required)
byte stream you want to save
Example
See this example in Java for how to share a file. Note: The java example sets the content-type before sending the object to the API. The api will store whatever content type it gets sent and use that to return the object when you get it at a later time. If no content type is set the API cannot determine what the stream of bytes means and will return it with a general content type later. This may cause issues if you are trying to download the files from the API at a later date if the content type is not set. A good list of content/media types can be found here: http://en.wikipedia.org/wiki/Internet_media_type
Example Response
{
response: {
action: "Share"
success: true
message: "New binary share added successfully. ID in data field"
time: 10
}
}