Socialid.login.loginCredentials
(Difference between revisions)
Renato.neves (Talk | contribs) |
Renato.neves (Talk | contribs) (→API Response) |
||
| Line 35: | Line 35: | ||
{| | {| | ||
! align="left" width="200px" | data | ! align="left" width="200px" | data | ||
| − | | | + | | In case of success, it'll be a Javascript object containing the [[socialid.events.onLoginSuccess]] event data. In case of login error, it'll be a Javascript object containing the [[socialid.events.onLoginError]] event data. It is important to note that these events will also be fired, that is, it is recommended to implement handlers for these events instead of handle the response of this API. |
|+ | |+ | ||
! align="left" width="200px" | status | ! align="left" width="200px" | status | ||
| − | | | + | | The API response status. Can be '''"success"''', if the user has been logged in successfully, '''"not_found"''', if there is no Social Login application found, '''"forbidden"''', if the login has not been authorized, '''"not_implemented"''', if the provider is not supported, or '''"internal_server_error"''', If some unknown error occurs. |
|} | |} | ||
Revision as of 11:47, 4 November 2014
Contents |
Description
API to automatically log an user given its social networks credentials.
For now only the Facebook provider is supported. To get the access token you can use the Facebook API FB.getLoginStatus, available in Facebook SDK para Javascript.
A common use case of this API is to integrate with any existing solution that uses the Facebook Javascript SDK. This way it's simple to feed the Social Login (and the Marketing Database) with the user's social information.
This method can trigger the following events:
Usage
socialid.login.loginCredentials(provider, token, handler)
Parameters
| provider | required | Login provider (social network). For now only "facebook" is supported. | token | required | User access token in the social network. | handler | optional | Callback function to handle the API response. |
|---|
API Response
| data | In case of success, it'll be a Javascript object containing the socialid.events.onLoginSuccess event data. In case of login error, it'll be a Javascript object containing the socialid.events.onLoginError event data. It is important to note that these events will also be fired, that is, it is recommended to implement handlers for these events instead of handle the response of this API. | status | The API response status. Can be "success", if the user has been logged in successfully, "not_found", if there is no Social Login application found, "forbidden", if the login has not been authorized, "not_implemented", if the provider is not supported, or "internal_server_error", If some unknown error occurs. |
|---|
Example
Loga um usuário na sessão atual dado seu access token do Facebook:
var handler = function(response) {
if (response.status == "success") {
alert("Usuário logado com sucesso");
} else {
alert("Não foi possível logar o usuário.");
}
}
var appId = 1;
socialid.login.init(appId);
FB.getLoginStatus(function(response) {
if (response.status === 'connected') {
// the user is logged in and has authenticated your
// app, and response.authResponse supplies
// the user's ID, a valid access token, a signed
// request, and the time the access token
// and signed request each expire
var uid = response.authResponse.userID;
var accessToken = response.authResponse.accessToken;
socialid.login.loginCredentials('facebook', accessToken, handler);
} else if (response.status === 'not_authorized') {
// the user is logged in to Facebook,
// but has not authenticated your app
} else {
// the user isn't logged in to Facebook.
}
});
Example of "data" object:
data = {
event: "onLoginSuccess",
token: "13d7555531d285adc34e21e7a9c583967c7a85507deee61fb6f1eeffc656409w",
callback_url: "https://sid-examples.herokuapp.com/social_logins",
provider: "facebook"
}
You can test this parameters in our playground: https://sid-examples.herokuapp.com/social_logins/playground
