Llamada api para fichar

Como fichar usando la api

Para poder fichar con se deberan hacer 2 llamadas, primero la llamada para inicar sesion y generar el token
https://tu-instalacion.lematic.es/api/login
Esta es una llamada POST, con los siguientes valores:
- username
- password
- name
username y password son eso, el usuario y la contraseña del usuario, y name siempre sera LoginToken

Esto deberia devolverte un json con el siguiente formato

{
    "token": "246|g9sSpr7b9iPYUJkxl8PqlmOBqLWEeLKjPGXXVTCZ",
    "status": "success",
    "condiciones_aceptadas": "2025-05-16 08:03:00"
}

Aqui, cojeremos el token, pero solo la parte que va despues del simbolo |
es decir, en este ejemplo, cogerias solo el valor que va despues de 246|
El caracter | solo aparece como separador del ID y el token, asique podemos buscar lo que va despues de | para coger solo el token

Ese token es el token del login, el cual podremos guardar ya que lo usaremos en cada llamada de fichaje que hagamos, los token puede ser que caduquen, asique cuando la llamada api de fichar devuelva lo siguiente

{
    "message": "Unauthenticated."
}
 
tendremos que volver a ejecutar la api de login

Una vez tenemos el token, para fichar, llamaremos a esta url: https://tu-instalacion.lematic.es/api/fich/fichar
Es una llamada POST, a la cual hay que pasarle los siguientes parametros
- tipo -> entrada,salida,pausa,vuelta,pausa almuerzo,vuelta almuerzo,pausa comida,vuelta comida
- nota
- fecha -> En formato YYYY-mm-dd (2026-06-01)
- hora -> en formato hh:ii:ss (07:00:00)
- zona_id -> id de la zona (si usamos zonas)
Ademas, hay que pasarle como bearer token el token que hemos generado con el login

Si el fichaje se ha realizado con exito, no devolvera nada, si hay algun error, devolvera un mensaje json con el error correspondiente
{
    "error": "Solo puedes fichar entrada después de una salida o si es tu primer fichaje."
}

Artículos relacionados

No hay artículos relacionados disponibles.