Next Topic

Previous Topic

Book Contents

Autenticar

Necessário para iniciar a sessão do VSA API do Serviço da Web A ID da sessão retornada precisa ser submetida com cada método chamado durante a sessão. A ID da sessão somente é válida quando recebida da mesma máquina da qual a autenticação se origina.

Um registro único dos seguintes campos é retornado.

ID da sessão

decimal

A ID única da sessão atribuída para um conexão de usuário com o URL de destino.

Método

sequência

A operação que solicitou esta resposta.

ID da transação

decimal

A ID única de mensagem para esta mensagem.

Mensagem de erro

sequência

Se estiver em branco, nenhum erro foi retornado.

Localização do erro

sequência

Se estiver em branco, nenhum erro foi retornado.

Login automático durante a autenticação

Quando você autentica através da API, será tmabém automaticamente conectado ao VSA. Se você já estiver conectado ao VSA no momento da autenticação, as 2 sessões são sincronizadas.  Seja a forma, o resultado é o mesmo - você termina tendo sessões válidas em ambos os mundos.

O VSA procuara pela ID de sessão da API de 26 dígitos na sequência de consulta de cada página VSA. Portanto, se o desenvolvedor do aplicativo precisa redirecionar para uma página VSA, ele agora pode ir diretamente para uma página sem forçar novo login pelo usuário. A sintaxe é:

URL?apiLogonGuid=12345678901234567890123456

Por exemplo:

http://someServer:123/Systemtab/SomePage?apiLogonGuid=12345678901234567890123456&SomeVar=SomeValue

A atividade API manté a sessão VSA ativa. No entanto, como o VSA não assume que sempre é necessária uma sessão API, a atividade VSA não mantém a sessão API ativa.

A API usa o mesmo valor de expiração que o VSA, que é mantido usando a página Política de login do sistema VSA, e tem um valor padrão do sistema de 30 minutos.