Saltar al contenido principal

Autenticación

Observación: Este método forma parte de la API Common, expuesta por el WebService Common.

El endpoint LoginSession autentica al usuario y crea una sesión en el WebService, devolviendo un token de autenticación (AuthToken) para utilizarlo en las demás llamadas a la API Common.


HTTP POST Request

Tipo de SolicitudURL Ejemplo
POST{{url_base}}/LoginSession
Ejemplohttp://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"LoginSession"

Parámetros de Entrada​

ParámetroTipoObligatorioDescripción
LoginString(100)SíUsuario para la autenticación en el sistema
EncryptedPasswordStringSíContraseña cifrada del usuario. Cuando la autenticación mediante Active Directory esté habilitada, debe enviarse en AES‑256/CBC, usando la misma clave que la aplicación móvil
BranchNoString(25)SíCódigo de la sucursal en la que el usuario se autentica

Retorno​

ParámetroTipoObligatorioDescripción
WebServiceReturnWebServiceReturnSíInformación estándar de respuesta del WebService en la ejecución del método.
SessionInfoDataLoginSessionInfoDataSíObjeto con los datos de la sesión autenticada, incluido el token de autenticación (AuthToken)

📝 Objeto LoginSessionInfoData​

El objeto LoginSessionInfoData representa la información de la sesión creada después del inicio de sesión.

Parámetros de Retorno​

ParámetroTipoObligatorioDescripción
UserCodeIntegerSíCódigo interno del usuario en el sistema
UserNameStringSíNombre abreviado del usuario
AuthTokenStringSíToken de autenticación generado para la sesión. Debe utilizarse en el campo AuthToken de las llamadas autenticadas.
AuthTokenExpirationDateTimeSíFecha y hora de expiración del token de autenticación (después de ese momento será necesario un nuevo inicio de sesión)

Ejemplo de Request​

curl --location 'http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"LoginSession"' \
--header 'Content-Type: application/json' \
--data '{
"Login": "edata",
"EncryptedPassword": "7012A6A2FE642116DE7BB",
"BranchNo": "0102",
"AuthType": "atMIMS"
}'

Ejemplo de Response​

{
"WebServiceReturn": {
"Status": "wrsSuccess",
"ErrorCode": "",
"Message": "",
"Actor": "",
"ReturnQuestion": null
},
"SessionInfoData": {
"UserCode": 12345,
"UserName": "USUARIO PRUEBA",
"AuthToken": "3F2C8A0D4B61441FAF9D0C2A6B8E9F10",
"AuthTokenExpiration": "2025-11-11T21:00:00"
}
}