Socialid.login.moveTo
(Difference between revisions)
Renato.neves (Talk | contribs) (→Example) |
Renato.neves (Talk | contribs) (→Description) |
||
| Line 3: | Line 3: | ||
Chama a API para mover os dados do usuário atualmente logado para um outro usuário identificado por "userId" e "userToken" e remove o usuário que estava logado. O outro usuário de "userId" herdará a conexão anterior e ficará logado. | Chama a API para mover os dados do usuário atualmente logado para um outro usuário identificado por "userId" e "userToken" e remove o usuário que estava logado. O outro usuário de "userId" herdará a conexão anterior e ficará logado. | ||
| − | O "userId" e "userToken" podem ser obtidos a partir da API [[GET login/info]] ou [[GET login/users/:user_id]] | + | O "userId" e "userToken" podem ser obtidos a partir da API [[GET login/info]] ou [[GET login/users/:user_id]]. |
| − | Esta API é útil para juntar usuários quando se sabe que são a mesma pessoa. | + | Esta API é útil para juntar usuários quando se sabe que são a mesma pessoa. |
| + | |||
| + | <span style="color: red">Importante:</span> veja a página de [[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:34, 2 September 2013
Contents |
Description
Chama a API para mover os dados do usuário atualmente logado para um outro usuário identificado por "userId" e "userToken" e remove o usuário que estava logado. O outro usuário de "userId" herdará a conexão anterior e ficará logado.
O "userId" e "userToken" podem ser obtidos a partir da API GET login/info ou GET login/users/:user_id.
Esta API é útil para juntar usuários quando se sabe que são a mesma pessoa.
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.moveTo(userId, userToken, handler)
Parameters
| userId | obrigatório | Id do usuário de destino, para o qual se deseja mover os dados do usuário atualmente logado. | userToken | obrigatório | Token do usuário de destino. | 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 movido com sucesso, "not_found", caso não exista um usuário logado no momento, ou "forbidden" caso não se tenha permissão para executar a operação. |
|---|
Example
Move o usuário da sessão atual para um outro usuário identificado por userId e userToken:
var handler = function(response) {
if (response.status == "success") {
alert("Usuário movido com sucesso");
} else if (response.status == "not_found") {
alert("Não há usuário logado no momento.");
} else {
alert("User_id e user_token não conferem.");
}
}
var appId = 1, userId = 34, userToken = '1234567890';
socialid.login.init(appId);
socialid.login.moveTo(userId, userToken, handler);
Teste as APIs em nosso playground: https://sid-examples.herokuapp.com/social_logins/playground
