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)Usuario para la autenticación en el sistema
EncryptedPasswordStringContraseñ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)Código de la sucursal en la que el usuario se autentica

Retorno

ParámetroTipoObligatorioDescripción
WebServiceReturnWebServiceReturnInformación estándar de respuesta del WebService en la ejecución del método.
SessionInfoDataLoginSessionInfoDataObjeto 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
UserCodeIntegerCódigo interno del usuario en el sistema
UserNameStringNombre abreviado del usuario
AuthTokenStringToken de autenticación generado para la sesión. Debe utilizarse en el campo AuthToken de las llamadas autenticadas.
AuthTokenExpirationDateTimeFecha 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"
}
}