Referencia API
La API REST de Flowtly: 927 endpoints en 192 recursos, generados a partir del esquema OpenAPI en vivo.
Esta referencia se genera a partir del esquema de la API. Las descripciones de los campos y cualquier texto aún sin traducir se muestran en inglés.
Antes de empezar a construir
Autenticación
Envía un token de acceso personal en la cabecera Authorization: Bearer <token>. Créalo en Flowtly, en la página de Seguridad de tu perfil. Un token actúa con tus propios permisos, dura 365 días salvo que elijas otro plazo (como máximo 730) y se puede revocar allí en cualquier momento.
Cabecera de organización
Cada solicitud lleva además una cabecera instance con el ID de la organización en la que actúas. Sin ella, la API rechaza la solicitud.
Solicitudes y respuestas
Las respuestas son JSON-LD (application/ld+json) o JSON plano (application/json). Las actualizaciones usan PATCH con application/merge-patch+json. Las colecciones se paginan con page y itemsPerPage, con un máximo de 500 elementos por página.
Versionado
La API no tiene versiones en sus rutas ni en sus cabeceras: los recursos están en la raíz, por ejemplo https://api.flowtly.eu/projects. El documento OpenAPI 3.1 se publica en https://api.flowtly.eu/docs.json.
Límites de frecuencia
Las solicitudes tienen un límite de frecuencia. Las solicitudes de escritura (POST, PUT, PATCH, DELETE) se cuentan por organización en una ventana de cinco minutos, con un límite mayor cuando la organización está verificada o suscrita. Al superar un límite, la API responde 429 Too Many Requests con una cabecera Retry-After que indica los segundos de espera. Los límites pueden cambiar, así que lee Retry-After en lugar de fijar un número en el código.
Obsolescencias
Un endpoint o campo que se va a retirar aparece marcado como deprecated en el documento OpenAPI. La API no envía cabeceras de obsolescencia, así que consulta el documento cuando actualices una integración.
Probar tu integración
No existe un entorno de pruebas aparte. Prueba tu integración en un espacio de trabajo de prueba con datos de ejemplo antes de conectar datos reales. Mientras la organización no esté verificada ni suscrita, una prueba funciona con un límite de escritura más bajo y no envía correos electrónicos.
Qué ha cambiado
Los cambios de la API se anuncian en las notas de versión, junto con el resto del producto.
Leer las notas de versiónProyectos y entregas
97Proyectos, tareas, miembros, tarifas y asignaciones — automatiza la entrega y sincroniza los datos del proyecto.
Asignación de recursos y capacidad
11Asignaciones, el banco de recursos, la ventana del calendario y los datos reales: planifique quién trabaja en qué y consulte lo que hicieron.
Facturación y pagos
49Facturas, líneas, pagos, recordatorios y facturación electrónica (KSeF) — automatiza la facturación de principio a fin.
Presupuestos y gastos
159Presupuestos, transacciones, costes, impuestos y cuentas bancarias — controla el gasto y concilia automáticamente.
CRM — leads y negocios
78Leads, negocios, pipelines y etapas — impulsa el embudo de ventas desde tus propios sistemas.
Clientes y contrapartes
34Clientes, contactos y contrapartes — mantén tu CRM y Flowtly sincronizados.
RR.HH. y personas
87Empleados, departamentos, puestos, beneficios y responsabilidades — automatiza los flujos de datos de RR. HH.
Rendimiento y evaluaciones
31Ciclos de evaluación, plantillas, preguntas y sesiones — ejecuta evaluaciones de rendimiento mediante programación.
Tiempo y asistencia
67Tiempo de trabajo, permisos, horarios y días festivos — registra y lee asistencia programáticamente.
Reclutamiento y ATS
40Candidatos, tareas de reclutamiento, entrevistas y programación — conecta tu ATS.
Propiedades y activos
50Propiedades, reservas, activos, contadores y lecturas — gestiona datos inmobiliarios a través de la API.
Contratos y cumplimiento
48Acuerdos, contratos, adjuntos y calendarios de pago — automatiza los flujos de trabajo de contratos.
Documentos y firmas
20Documentos, almacenamiento y solicitudes de firma electrónica — sube, organiza y firma archivos.
Personalización y etiquetas
62Atributos, conjuntos de atributos, reglas y etiquetas — amplía los objetos de Flowtly con tus propios campos.
Organización y configuración
48Organización, ubicaciones, usuarios, integraciones y suscripción — configura el espacio de trabajo.
Usuarios y acceso
16Usuarios y grupos de permisos — gestiona quién puede ver y hacer qué.
Webhooks y auditoría
14Webhooks y registros de auditoría — reacciona a eventos y realiza un seguimiento de los cambios.
Exportaciones contables
16Exportaciones a Wapro, Optima, Enova, Symfonia, MT940 y SEPA — entrega los datos a tu contable.
Servidor MCP
Conecta herramientas de IA a Flowtly a través del Model Context Protocol en mcp.flowtly.eu.