OAuth2 AeroGear Workflow - High Level

Using Google api's

Server Side

user needs to first create an "application/project" to get an api key
Then they would choose the services/api's then would like there application to access
other google server related items....

Client Side

Create a new OAuth2 module thing
Get access token for the services would need to specify the services they would like to access
validate the token
make calls to the service

API

var thing = AerGear.OAuth2({
                name: googleEndPoints, //Just a Name
                clientID: "12345" //The client ID of the app from the API console
                settings: {
                    permissions: "..",
                    ...
                }
            }).somecoolmodulename.googleEndPoints;

Settings: Multiple settings based on paramters here

Methods

authenticate

this will authenticate with the server to get the access token and then validate the token, once that is all good then the response is returned.

thing.authenticate({
    success:{},
    error:{},
    settings: {
        //probably some settings here, like URL overides and such
    }
});

callApi

not really a good name, but it would basically call the remote api/services. we could either do a query string option or a Head option

example:

curl 'https://www.googleapis.com/oauth2/v1/userinfo?access_token=1/fFBGRNJru1FQd44AzqT3Zg'

curl -H "Authorization: Bearer {accessToken}" https://www.googleapis.com/oauth2/v1/userinfo

code:

thing.callApi({
    service: "userinfo", //don't really like this name either
    success:{},
    error:{},
    settings: {
        ... //overridable baseURLs?
    }
});

revoke

again, maybe not the best name. calls the "revoke" service, to remove access to permissions

thing.revoke({
    success: {},
    error: {},
    settings: {}
});

Behind the scenes on all these calls, the "access_token" is beining used and possibly refreshed for the user, so they don't have to worry about it. They just need to call authenticate first. Maybe we can have a refresh method if the user wants to refresh the tokens themselves. this would do the token "dance"