Login

Inicia la sesión de un usuario de TrakIT y devuelve un token. Envíe el token en un encabezado Token con todas las demás llamadas de la API de integración, por ejemplo GetEntity o GetLocations. Inicie sesión una vez y siga usando el token hasta que una llamada lo rechace: consulte Caducidad del token. Cuando la integración ya no necesite el token, cierre su sesión con Logout. Solo puede iniciar sesión un usuario con acceso a la API.

Cómo iniciar sesión y leer la respuesta: Autenticación, Respuestas.

POST /api/v1/Login
Content-Type: application/json

{
  "User": "jsmith",
  "Password": "your-password"
}

Campo	Obligatorio	Significado
`User`	Sí	El identificador de usuario del usuario en TrakIT, o la dirección de correo electrónico de su ficha de usuario. Las mayúsculas no importan.
`Password`	Sí	La contraseña del usuario. Distingue entre mayúsculas y minúsculas.

La solicitud no lleva encabezado Token: Login es la única llamada que no lo necesita.

Reglas

Regla	`Info` si no se cumple
La solicitud tiene un cuerpo JSON.	`LoginInfo must be supplied`
Se indica `User`.	`User ID or Email must be supplied`
Se indica `Password`.	`Password must be supplied`
`User` no está formado solo por espacios.	`User ID or Email is required`
Un `User` con `@` es una dirección de correo electrónico bien formada.	`Email ... is invalid`
Ha habido menos de cinco inicios de sesión fallidos con este `User` en los últimos 30 minutos.	`Five unsuccessful attempts made. Try again after 30 minutes.`
El identificador de usuario o la dirección de correo electrónico y la contraseña son correctos.	`User ID / Email or Password is incorrect`
La ficha de usuario tiene una dirección de correo electrónico.	`Sign In Permission Denied`
La ficha de usuario supera la comprobación de integridad de TrakIT. Si no, póngase en contacto con el soporte de TrakIT.	`User Hash verification failed`
El usuario no está bloqueado.	`User account is locked`
Su instalación de TrakIT se ha actualizado en los últimos 90 días.	`Sign-in is disabled because this TrakIT installation has not been updated in the last 90 days. ...`
El usuario puede iniciar sesión en algún sitio: al menos un modo de acceso está activado.	`User account not permitted to logon`
El usuario tiene el modo de acceso API.	`User account is not permitted to sign in from the API`
La contraseña del usuario no ha caducado, si su empresa hace que las contraseñas caduquen. Consulte Caducidad de la contraseña.	`Your password has expired. Sign in to TrakIT in a web browser to change it.`
El usuario no tiene autenticación en dos pasos: `Login` no puede recibir un código de un solo uso.	`Two-factor authentication is on for this user, and the API cannot take a code. Use an API user without two-factor authentication.`
Las validaciones de inicio de sesión de su empresa, si las tiene (User > Login en Validaciones y acciones), se superan.	El propio mensaje de la validación

Un usuario con autenticación en dos pasos no puede usar la API de integración, sea cual sea el tipo de código que use: use un usuario sin ella. Login no envía ningún código a ese usuario.

Respuesta

Si tiene éxito, Info contiene el token. RetInfo es null, y RowsAffected e Identity son 0.

{
  "Code": 1,
  "Info": "your-token",
  "RetInfo": null,
  "RowsAffected": 0,
  "Scalar": null,
  "Identity": 0
}

Trate el token como una cadena opaca: devuélvalo exactamente como lo recibió y manténgalo tan en secreto como la contraseña.

Notas

Cada Login correcto inicia una nueva sesión, que aparece como sesión de API en la pestaña Session Log del usuario. Los tokens de inicios de sesión anteriores siguen funcionando hasta que dejan de ser válidos, así que vuelva a iniciar sesión solo cuando una llamada responda Token invalid or expired.
Si el mismo usuario ha iniciado sesión en TrakIT en un navegador web desde otra conexión a internet, Login cierra allí su sesión: la siguiente página que abra le lleva de vuelta a la página de inicio de sesión. Reserve un usuario para la integración.
Una contraseña incorrecta, o un identificador de usuario o una dirección de correo electrónico que no existen, cuentan como un inicio de sesión fallido. Tras cinco en 30 minutos, TrakIT rechaza ese User hasta que el más antiguo de ellos tiene más de 30 minutos, incluso con la contraseña correcta. Cada tres horas, TrakIT envía por correo electrónico a sus administradores del sistema un resumen de los inicios de sesión fallidos desde el último resumen.
Las acciones de inicio de sesión de su empresa, si las tiene, se ejecutan con Login igual que en un inicio de sesión en un navegador web.
TrakIT registra cada llamada a Login con el User enviado, nunca con la contraseña.