FlexiProject ofrece una API REST con la que otro sistema puede leer y modificar los datos de la organización: alimentar un informe de BI, sincronizar proyectos con un ERP o automatizar una tarea repetitiva. La descripción completa de los endpoints está en developers.flexi-project.com.
Para llamar a la API necesitas un token de acceso personal (token de API). Lo creas tú mismo en tu perfil, en la pestaña API, y funciona con tus permisos: la API muestra exactamente los datos que ves en la aplicación y nada más.
Token de acceso personal
Quién puede crear un token
Un token para la propia cuenta lo crean los usuarios con licencia Completa (consulta Licencias) y los administradores del sistema; la pestaña API solo les es visible a ellos. No hace falta el permiso de administrador. El token lleva los permisos de su propietario, por lo que llega a los mismos proyectos y campos que el propietario ve en la aplicación. Dos personas con roles distintos obtienen resultados distintos con la misma petición.
Un token deja de funcionar cuando la cuenta se desactiva, se elimina de la organización o se bloquea, así que no tienes que limpiar los tokens cuando alguien se va.
Crear un token
- Abre el menú del avatar, elige Perfil del usuario y ve a la pestaña API (consulta Perfil del usuario).
- Haz clic en Nuevo token.
- Escribe un nombre en el campo Nombre, de 100 caracteres como máximo. El nombre debe indicar a qué integración sirve el token, porque es la única forma de distinguir tus tokens más adelante.
- Establece la Fecha de caducidad. La más próxima es mañana y la más lejana, dentro de 365 días; el campo se abre en 30 días. El token caduca al final del día elegido.
- Haz clic en Crear token.
Copiar el token de inmediato
La ventana El token de acceso personal ha sido creado muestra el valor completo una sola vez, con un aviso: Copia el token y guárdalo en un lugar seguro: una vez cerrada esta ventana, ya no será posible volver a verlo. El botón Copiar copia el valor al portapapeles y lo pegas directamente en el sistema que lo va a usar. Después de cerrar la ventana nadie puede recuperar el valor: ni tú, ni un administrador, ni el soporte. Si pierdes un token, elimínalo y crea uno nuevo.
Lista de tokens
La pestaña API muestra tus tokens en las columnas Nombre, Token, Creado y Caduca. La columna Token muestra solo los primeros caracteres del valor, suficientes para relacionar un token con el que está guardado en una integración.
La columna Caduca avisa con antelación: un token que caduca en menos de siete días lleva una etiqueta con el número de días que quedan, uno que caduca hoy muestra caduca hoy y uno vencido muestra caducado. Un token caducado permanece en la lista hasta que lo eliminas, pero ya no autentica nada.
Puedes tener a la vez hasta diez tokens activos. Cuando se alcanza el límite, la aplicación rechaza crear otro con el mensaje Ya tienes 10 tokens de acceso personal activos. Elimina un token que no utilices para crear uno nuevo. Los tokens caducados no cuentan para el límite.
Eliminar un token
El icono de la papelera en la fila de un token lo elimina tras una confirmación. La aplicación advierte de que las integraciones que lo utilizan dejarán de funcionar inmediatamente, y así es: en su siguiente petición. La eliminación no se puede deshacer; sustituir un token siempre significa un token nuevo con un valor nuevo.
Usar un token
Un token de API no se envía con cada petición. Lo cambias una vez por un token de acceso y usas ese token de acceso a partir de entonces.
Envía un POST a /api/user/token/personal con tu dirección de correo electrónico y el valor del token:
POST /api/user/token/personal
Content-Type: application/json
{ "email": "anna.kowalska@example.com", "token": "fpat_…" }La respuesta contiene el access_token, su tipo, el identificador de la organización a la que pertenece el token y el número de segundos que es válido. Envía el token de acceso en la cabecera Authorization de las llamadas siguientes y repite el intercambio cuando caduque.
La dirección de correo electrónico debe pertenecer a la cuenta que creó el token, y el propio token decide a qué organización accedes: si trabajas en más de una, crea un token distinto en cada una.
Los intentos fallidos repetidos están limitados: después de diez intentos fallidos con la misma dirección de correo electrónico, los siguientes se rechazan durante quince minutos. Si una integración empieza de repente a recibir rechazos en masa, revisa el valor guardado en lugar de reintentar en bucle.
El intercambio de un token de API también funciona cuando el inicio de sesión con contraseña está desactivado, porque no es una persona la que inicia sesión (consulta Métodos de inicio de sesión).
