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ón

Proyectos y entregas

97

Proyectos, tareas, miembros, tarifas y asignaciones — automatiza la entrega y sincroniza los datos del proyecto.

Asignación de recursos y capacidad

11

Asignaciones, 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

49

Facturas, líneas, pagos, recordatorios y facturación electrónica (KSeF) — automatiza la facturación de principio a fin.

Presupuestos y gastos

159

Presupuestos, transacciones, costes, impuestos y cuentas bancarias — controla el gasto y concilia automáticamente.

CRM — leads y negocios

78

Leads, negocios, pipelines y etapas — impulsa el embudo de ventas desde tus propios sistemas.

Clientes y contrapartes

34

Clientes, contactos y contrapartes — mantén tu CRM y Flowtly sincronizados.

RR.HH. y personas

87

Empleados, departamentos, puestos, beneficios y responsabilidades — automatiza los flujos de datos de RR. HH.

Rendimiento y evaluaciones

31

Ciclos de evaluación, plantillas, preguntas y sesiones — ejecuta evaluaciones de rendimiento mediante programación.

Tiempo y asistencia

67

Tiempo de trabajo, permisos, horarios y días festivos — registra y lee asistencia programáticamente.

Reclutamiento y ATS

40

Candidatos, tareas de reclutamiento, entrevistas y programación — conecta tu ATS.

Propiedades y activos

50

Propiedades, reservas, activos, contadores y lecturas — gestiona datos inmobiliarios a través de la API.

Contratos y cumplimiento

48

Acuerdos, contratos, adjuntos y calendarios de pago — automatiza los flujos de trabajo de contratos.

Documentos y firmas

20

Documentos, almacenamiento y solicitudes de firma electrónica — sube, organiza y firma archivos.

Personalización y etiquetas

62

Atributos, conjuntos de atributos, reglas y etiquetas — amplía los objetos de Flowtly con tus propios campos.

Organización y configuración

48

Organización, ubicaciones, usuarios, integraciones y suscripción — configura el espacio de trabajo.

Usuarios y acceso

16

Usuarios y grupos de permisos — gestiona quién puede ver y hacer qué.

Webhooks y auditoría

14

Webhooks y registros de auditoría — reacciona a eventos y realiza un seguimiento de los cambios.

Exportaciones contables

16

Exportaciones 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.