Socialid.login.loginCredentials
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