Autenticar

Necesario para iniciar el servicio Web API VSA. La SessionID que se devuelve debe enviarse con cada método invocado durante la sesión. La SessionID sólo es válida cuando se recibe desde la misma máquina en la que se origina la autenticación.

Se devuelve un registro simple de los siguientes campos.

SessionID	decimal	La ID única de sesión asignada a una conexión de usuario con el URL de destino.
Método	cadena de caracteres	La operación que solicitó esta respuesta.
TransactionID	decimal	La ID única de mensaje para este mensaje.
ErrorMessage	cadena de caracteres	Si está en blanco, no devolvió error.
ErrorLocation	cadena de caracteres	Si está en blanco, no devolvió error.

Conexión automática durante la autenticación

Cuando autentica a través del API, también se conecta automáticamente al VSA. Si ya está conectado en el VSA en el momento de autenticación, las 2 sesiones se sincronizan. De cualquier manera, el resultado es el mismo– termina con sesiones válidas en ambos mundos.

El VSA busca la SessionID de 26 dígitos del API en la cadena de consulta de cada página del VSA>. De manera que, si el desarrollador de la aplicación necesita redireccionarse a una página VSA, ahora puede ir directamente a una página sin forzar al usuario a registrarse nuevamente. La sintaxis es:

URL?apiLogonGuid=12345678901234567890123456

Por ejemplo:

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

La actividad API mantiene con vida a la sesión del VSA. Sin embargo, debido a que el VSA no asume que siempre hay necesidad de una sesión API, la actividad del VSA no mantiene con vida a la sesión API.

El API utiliza el mismo valor de expiración que el VSA, que se mantiene utilizando la página del VSA Sistema > Política de conexión y tiene un valor predeterminado del sistema de 30 minutos.

Punto 3494: Enviar Comentario. Descargue un PDF de este libro en línea del primer punto en la tabla de contenidos.