Socialid.login.loginConnection
Renato.neves (Talk | contribs) (→Description) |
Renato.neves (Talk | contribs) (→Description) |
||
| Line 5: | Line 5: | ||
O connection_id pode ser obtido a partir da API [[GET login/info]]. Também é possível criar uma nova conexão a partir de um user_id, usando a API [[POST login/apps/:app_id/sign_ins]], ou a partir das credenciais de alguma rede social do usuário. Veja as [[Social Login APIs|APIs do Social Login]]. | O connection_id pode ser obtido a partir da API [[GET login/info]]. Também é possível criar uma nova conexão a partir de um user_id, usando a API [[POST login/apps/:app_id/sign_ins]], ou a partir das credenciais de alguma rede social do usuário. Veja as [[Social Login APIs|APIs do Social Login]]. | ||
| − | Um caso de uso desta API é para quando a sessão (cookie) do usuário no Social Login tenha expirado ou sido apagada e se queira logar automaticamente um usuário já identificado (via login tradicional ou outro meio). | + | Um caso de uso desta API é para quando a sessão (cookie) do usuário no Social Login tenha expirado ou sido apagada e se queira logar automaticamente um usuário já identificado (via login tradicional ou outro meio). |
| + | |||
| + | <span style="color: red">Importante:</span> veja [[Social Login Tokens|Tokens do Social Login]] para maiores informações sobre os tokens usados no Social Login e boas práticas de segurança. | ||
== Usage == | == Usage == | ||
Revision as of 14:31, 2 September 2013
Contents |
Description
Chama a API para logar automaticamente um usuário dado seu connection_id.
O connection_id pode ser obtido a partir da API GET login/info. Também é possível criar uma nova conexão a partir de um user_id, usando a API POST login/apps/:app_id/sign_ins, ou a partir das credenciais de alguma rede social do usuário. Veja as APIs do Social Login.
Um caso de uso desta API é para quando a sessão (cookie) do usuário no Social Login tenha expirado ou sido apagada e se queira logar automaticamente um usuário já identificado (via login tradicional ou outro meio).
Importante: veja Tokens do Social Login para maiores informações sobre os tokens usados no Social Login e boas práticas de segurança.
Usage
socialid.login.loginConnection(connectionId, handler)
Parameters
| connectionId | obrigatório | Identificador da conexão do usuário. | handler | opcional | Especifica uma função de callback para tratar a resposta da API. |
|---|
API Response
| data | Sempre "null". Esta API não retorna dados. | status | O status da execução da chamada da API. Pode ser "success", se o usuário foi logado com sucesso, ou "not_found", caso não exista a conexão especificada por connectionId. |
|---|
Example
Loga um usuário na sessão atual dado seu connection_id:
var handler = function(response) {
if (response.status == "success") {
alert("Usuário logado com sucesso");
} else {
alert("Conexão inexistente. Gere outro connectionId.");
}
}
var appId = 1, connectionId = '1234567890';
socialid.login.init(appId);
socialid.login.loginConnection(connectionId, handler);
Teste as APIs em nosso playground: https://sid-examples.herokuapp.com/social_logins/playground
