Don’t you just love an exciting headline. If you haven’t heard by now, Share (Document Services API) is an online service provided by Adobe that allows you to share, publish, and organize documents online. Share is already a good service, but it can be an even better service with a little help from all of us. How can we make the service better?
1. Use the service and give feedback on the Share Forum. Whether you’re happy or not they want to hear about it. Have a feature idea, pass it on.
Share Forum
Share API Forum
2. Tell other people about the service. Its 1gb of free space for your documents. Who doesn’t like free.
https://share.acrobat.com
3. Create and share your own projects around the service.
4. Contribute to open source projects that use the Share API.
There are many open source libraries that allow you to easily use the Share Service in your applications (listed at the bottom). One of these libraries is the ActionScript library. Developed internally at Adobe, it has the full original functionality of the service but has fallen behind in the latest revisions of the Share Service. So when speaking to Fang Chang (Adobe Product Manager in charge of the Share APIs) this past week I offered to help bring an updated version of the ActionScript library into the hands of the community. Fang who is a very patient man, (listened to all my feature idea ramblings) felt like it would be a great move. So here we are.
What has been done?
1. The as3 library has been updated to work with the new endpoint and pdf creation support has been added
2. Updated AirShare demo for the release version of AIR.
3. The code has been checked into subversion
4. Documentation has been generated
5. A release has been made that includes the updated source/example.
Example of upload with pdf creation:
import com.adobe.share.api.ShareAPIToken; import com.adobe.share.api.ShareAPIEvent; import com.adobe.share.api.ShareAPIUser; import com.adobe.share.api.ShareAPI; private var _shareAPI:ShareAPI = new ShareAPI("<api key>", "<secret>"); private var _shareAPIUser:ShareAPIUser = new ShareAPIUser("<share user name>", "<share password>"); private var _file:File = new File(); private function initApp():void{ var shareAPIToken:ShareAPIToken = _shareAPI.login(_shareAPIUser); shareAPIToken.addEventListener(ShareAPIEvent.API_AUTHENTICATED, function():void{ _file.browse(); _file.addEventListener(Event.SELECT, onFileSelected); _file.addEventListener(DataEvent.UPLOAD_COMPLETE_DATA, onFileUploadComplete); }); } private function onFileSelected(event:Event):void{ _shareAPI.uploadFile(_shareAPIUser, _file, null, _file.name, "", true, true); } private function onFileUploadComplete(event:DataEvent):void{ trace("complete"); }
Want to contribute to the Library?
Please contact me or select join from the project site.
Other Share Libraries:
Java Library
Ruby (Developed by Hideyuki KATO) Ruby
Python (Developed by Vivek Kapoor) Python
Cold Fusion (Developed by Ray Camden) Cold Fusion
