Autenticação (LOGIN_SESSAO)

O controle de acesso as funções dá-se pelo tradicional modelo de conta e senha, sendo ambos referentes a algum usuário ativo.  Ao chamar o serviço de autenticação é retornado um código denominado ID_SESSAO, que deve ser encaminhado como parâmetro para todas as demais funções do sistema.

As sessões expiram por inatividade e é responsabilidade do client renová-las

Na versão 1.0 de nossa API o cliente, ou seja, o aplicativo que irá consumir as funções do McFile deve administrar a sessão do usuário e renová-la chamando o webservice de autenticação sempre que receber um erro de “sessão inválida” nas demais funções.

Serviço de Login com geração de Sessão (LOGIN_SESSAO)

Autentica um usuário no McFile, retornando um token válido de sessão e outros parâmetros necessários a conexão.

É a primeira função a ser chamada para o uso dos demais serviços do McFile e deve ser chamada novamente sempre que houver um erro de sessão inválida em qualquer outra função da API 1.0

Essa função também retorna a URL a ser usada para upload e download de arquivos, a qual é gerenciada por outro serviço, o McEscritorio.

Nome do serviço:

CtrlServicos?cmd=LOGIN_SESSAO

Exemplos de código para referência:

login_sessao.pas

McClasses.pas

Principais parâmetros de entrada:

NOME TIPO EXEMPLO
Conta String fulano@email.com
Senha String Abacate



Principais parâmetros de retorno:
NOME TIPO DESCRICAO
idSessao Integer Deve ser passado como parâmetro para outros serviços do McFile
authToken String É usado para autenticação no serviço de arquivos McEscritorio
Nome String Nome do usuário
Domínio String Nome do cliente ou subdomínio em *.mcfile.com
urlEscritorio String URL para acesso ao serviço de arquivos McEscritorio
alterarSenha Boolean Indica se a senha do usuário está expirada
areas Array de TArea Array das área de sigilo as quais o usuário em questão tem acesso de leitura e/ou edição
codAreaCadastroDefault Integer Area de sigilo default de cadastramento de conteúdo pelo usuário