The core of this package is the class com.alpha0.rest.MySpaceXML, and, along with the supporting files, that's all you really need. If you scroll down to the "// MySpace Services" comment in the file you will see all the methods you can use to call REST services. In those methods, all the parameters including and after os_token are optional and will switch the calls from using OAuth authentication to using the token-based authentication.
The file simpleTest.fla has a couple of simple examples of using MySpaceXML and MySpaceOAuthRequest & MySpaceTokenRequest separately.
The file TestMySpaceREST.fla is intended more as documentation than as a usage sample. You can set this file up, via TestMySpaceREST.as, to test service calls and see the object tree MySpaceXML returns as a result. To test token-based results you'll either have to upload the SWF as your App Source, or pull those FlashVars out of the SWF you upload (from say the canvas page source) and plug those in to TestMySpaceREST.as. The calls will work from the Flash IDE, but will get blocked by myspace's crossdomain.xml if you try to run them outside of the IDE or the myspace domain.
The class MySpaceXML subclasses XML so you can always pull the results out of it by using firstChild.toString(), but I've added functionality to parse the XML to an object tree making access to data a little easier. Rather than writing documentation for those data structures, I created TestMySpaceREST.fla as a tool to view those structures.
Here are some differences between OAuth request and Token request. You can use a Token request to with VIEWER or OWNER to get those all important user IDs from Flash. The OAuth request require a user ID and are not limited to retrieving data of just the viewer or owner, but can retrieve data for any of your app users and in some cases their friends. Also, at this time, OAuth request support a greater range of REST services.
Here's a list of services that are currently implemented:
getUser() - works on both
getUserProfile() - works on both
getFriends() - works on both
isFriendOf() - works on both
getAlbums() - works on both
getAlbum() - works on both
getPhotos() - works on both
getPhoto() - works on both
getInterest() - OAuth only
getVideos() - works on both
getVideo() - works on both
getGroups() - Removed from docs
getStatus() - OAuth only
getMood() - OAuth only
getComments() - Removed from docs
getAppData() - works on both
setAppData() - Token only
NEW
getIndicators() - works on both
getFriendsAppData() - works on both
getGlobalAppData()- works on both
setGlobalAppData() - Token only
I'll add new services as they come along and repost new versions here.
I'm assuming that the token-based services currently not working will start working if MySpace adds functionality for them.
Also, let me know if you find any bugs and I'll try to fix and post those as well.
~Brock
brock[at]splascastmedia.com