My understanding is the following, please let me know if I'm wrong:
- everything provided for developers on MySpace use the REST API in the end, whether this is the OpenSocial Javascript lib, DA, whatever. So whatever entry point we choose, the maximum feature set we can get is described in the REST API reference, which is here: http://developer.myspace.com/community/RestfulAPIs/resources.aspx and also some OpenSocial support described here: http://developer.myspace.com/community/myspace/da.aspx
- DA makes it possible to use the REST API from outside of a client app, and basically enables OAuth authentication (requesting request token, authorizing app, requesting access token) and OpenSocial access.
- the API tool at http://developer.myspace.com/modules/apis/pages/devtool.aspx makes REST API calls, OAuth formatted, but without using a token. Apparently it gets its authentication through the consumer key, which is formatted is a strange way, at least not the way we are supposed to use it from an external app. I guess this is because MySpace generates this key internally and this is sufficient to identify the user/app key and make sure the user is logged in at the time of request.This tool only work for the user currently logged in.
- the OAuth tool at http://developer.myspace.com/modules/apis/pages/oauthtool.aspx has basically the same purpose as the API tool, except that it works with a token, so we have to have a valid access token to use it, that we have for example obtained through the External App Auth page at http://developer.myspace.com/modules/apis/pages/accessdelegationtool.aspx. The OAuth tools then makes it to possible to make requests for different users than the one currently logged in.
- About marking an app as external: I think this is necessary for using the External App Auth at http://developer.myspace.com/modules/apis/pages/accessdelegationtool.aspx, because this is where callback URLs are defined. Now if you get your access token from other ways, maybe it is not necessary to have the app declared as external.