Socialid.login.loginConnection

From Social ID Developers
Revision as of 14:32, 2 September 2013 by Renato.neves (Talk | contribs)
Jump to: navigation, search

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 a página de 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

Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox