Socialid.login.loginCredentials
Renato.neves (Talk | contribs) (→API Response) |
Renato.neves (Talk | contribs) (→API Response) |
||
| Line 38: | Line 38: | ||
|+ | |+ | ||
! align="left" width="200px" | status | ! align="left" width="200px" | status | ||
| − | | O status da execução da chamada da API. Pode ser '''"success"''', se o usuário foi logado com sucesso, "not_found", caso não exista a aplicação de Social Login, "forbidden", caso o login não tenha sido autorizado, ou "not_implemented", caso o provider não seja suportado. | + | | O status da execução da chamada da API. Pode ser '''"success"''', se o usuário foi logado com sucesso, '''"not_found"''', caso não exista a aplicação de Social Login, '''"forbidden"''', caso o login não tenha sido autorizado, ou '''"not_implemented"''', caso o provider não seja suportado. |
|} | |} | ||
Revision as of 13:41, 27 January 2014
Contents |
Description
Chama a API para logar automaticamente um usuário dado seu access token das redes sociais.
Por enquanto apenas o Facebook é suportado. Para obter o access token pode-se usar a API FB.getLoginStatus, disponível no Facebook SDK para Javascript.
Um caso de uso desta API é para integrar com alguma solução já existente no Website que usa o Facebook SDK para Javascript. Desta forma fica simples sincronizar com o banco de dados do Social Login (e o Marketing Database) com os dados do usuário que acabou de se logar.
O uso deste método pode disparar os eventos:
Usage
socialid.login.loginCredentials(provider, token, handler)
Parameters
| provider | obrigatório | Provedor de login (rede social). Por enquanto apenas "facebook" é suportado. | token | obrigatório | Access token do usuário na rede social. | handler | opcional | Especifica uma função de callback para tratar a resposta da API. |
|---|
API Response
| data | Em caso de sucesso, será um objeto contendo as informações do evento socialid.events.onLoginSuccess. Em caso de erro de login, será um objeto com informações do evento socialid.events.onLoginError. É importante notar que estes eventos também serão disparados, ou seja, é recomendado implementar handlers para estes eventos em vez de tratar a resposta desta API. | status | O status da execução da chamada da API. Pode ser "success", se o usuário foi logado com sucesso, "not_found", caso não exista a aplicação de Social Login, "forbidden", caso o login não tenha sido autorizado, ou "not_implemented", caso o provider não seja suportado. |
|---|
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, provider = 'facebook', token = '1234567890';
socialid.login.init(appId);
socialid.login.loginCredentials(provider, token, handler);
Exemplo de dados no objeto "data":
data = {
event: "onLoginSuccess",
token: "13d7555531d285adc34e21e7a9c583967c7a85507deee61fb6f1eeffc656409w",
callback_url: "https://sid-examples.herokuapp.com/social_logins",
provider: "facebook"
}
Teste as APIs em nosso playground: https://sid-examples.herokuapp.com/social_logins/playground
