Integraciones
API REST: conecta Fichaloto con lo que ya tenéis
Las entidades del producto se leen y se escriben desde otro programa. Sin conectores de terceros, sin exportar a Excel los martes y sin pedirle nada a nadie.
Las mismas entidades que ves en pantalla
No hay una API que hace la mitad y una aplicación que hace la otra mitad. Las entidades y las reglas de validación son literalmente el mismo código, así que la API no puede aceptar lo que la pantalla rechaza ni al revés.
- Clientes, personas, equipos, proyectos, fases, tareas, hitos, agenda, ausencias y catálogos, con listado paginado, lectura de uno, alta, corrección parcial y baja. Las horas imputadas se listan, se leen y se borran.
- JSON sobre HTTPS, con verbos de siempre: GET, POST, PATCH y DELETE. La versión va en la URL, así que un cambio de contrato estrena versión y la anterior sigue respondiendo igual.
- Un endpoint que se describe solo. Una llamada a
/metadevuelve qué entidades hay y qué columnas admite cada una, y otra a/yodice qué puede hacer esa llave. Documentación que no se queda vieja porque sale del mismo sitio que el producto.
Una llave nunca puede más que su persona
La llave no es una identidad aparte con permisos propios: es una forma de entrar en nombre de alguien. Lo que puede es exactamente lo que puede esa persona, así que los permisos que ya habéis configurado valen igual para las integraciones y no hay un segundo sistema de accesos que mantener.
Encima lleva su propio interruptor de solo lectura, que puede apretar pero nunca aflojar lo que digan los roles. Dos cerrojos en serie: para escribir hacen falta los dos.
- El secreto se ve una vez. En base guardamos su huella, no la llave: si alguien se lleva la tabla, no se lleva ninguna llave. Perdida, se revoca y se crea otra.
- Se revoca en un clic y deja de funcionar en la siguiente petición. La llave de un programa que ya no se usa es una puerta abierta que nadie mira.
- Caducidad opcional y recomendable, y baja automática: si la persona dueña de la llave deja la empresa, la llave deja de entrar el mismo día.
- Tope de peticiones por minuto, para que un script en bucle no se lleve por delante la pantalla de quien está trabajando.
Y queda escrito quién lo hizo
Cada escritura desde la API va a la misma auditoría que las de pantalla, con el nombre de la llave que la hizo. Cuando dentro de seis meses aparezcan cuarenta horas imputadas que nadie recuerda, la respuesta está ahí y dice «llave del ERP», no «sistema».
Para cargas grandes, la importación
La API es para registro a registro y para mantener dos sistemas al día. Para meter cinco mil filas de histórico está la importación masiva desde hoja de cálculo, que analiza el fichero antes de tocar nada y enseña qué se va a crear, qué se va a actualizar y qué está mal. Lo que se exporta se vuelve a importar tal cual: la exportación sirve de plantilla.
Preguntas frecuentes
¿Qué hace falta para empezar?
Entrar en Configuración → API e integraciones y crear una llave. La pantalla trae la referencia de los endpoints y un ejemplo con curl, así que no hay que ir a buscar un manual a otro sitio.
¿Puedo dar acceso de solo lectura a un cuadro de mando?
Sí, y es lo recomendable. Se crea una persona para la integración, se le pone el rol de API de solo lectura y se marca la llave como solo lectura. Aunque alguien cambie el rol por error, la llave sigue sin poder escribir.
¿La API acepta la sesión del navegador?
No, y es a propósito. La identidad sale únicamente de la cabecera de autorización. Una API que aceptara cookies sería una API que cualquier página web podría hacer que tu navegador usara en tu nombre.
¿Tiene coste aparte?
No. La API entra con la plataforma, como todo lo demás, y no hay coste por llamada ni por integración. Si echáis en falta un endpoint, contádnoslo: las propuestas se miran y las que le sirven a más de una empresa entran en la hoja de ruta. Lo que no hacemos es programar un endpoint para un caso concreto.
Empezar
Catorce días completos, sin tarjeta y sin instalar nada. Si en ese tiempo no te ahorra trabajo, no hay nada que cancelar. Y si prefieres verlo antes, pide una demo y lo montamos con dos o tres de tus proyectos de verdad, que es donde se ve si encaja.