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 Solicitud | URL Ejemplo |
|---|---|
| POST | {{url_base}}/LoginSession |
| Ejemplo | http://seuIPePorta/datasnap/rest/RESTWebServiceMethods/"LoginSession" |
Parámetros de Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Login | String(100) | Sí | Usuario para la autenticación en el sistema |
| EncryptedPassword | String | Sí | 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 |
| BranchNo | String(25) | Sí | Código de la sucursal en la que el usuario se autentica |
Retorno
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| WebServiceReturn | WebServiceReturn | Sí | Información estándar de respuesta del WebService en la ejecución del método. |
| SessionInfoData | LoginSessionInfoData | Sí | 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ámetro Tipo Obligatorio Descripción UserCode Integer Sí Código interno del usuario en el sistema UserName String Sí Nombre abreviado del usuario AuthToken String Sí Token de autenticación generado para la sesión. Debe utilizarse en el campo AuthTokende las llamadas autenticadas.AuthTokenExpiration DateTime Sí 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"
}
}